@mhdd_24/workspace-build-mcp

MCP server and PowerShell scripts to build an Angular UI library and npm-link it into a consumer app. Short aliases (core, app) expand from config. GitHub workflows use the published mhdd24-cli (mhdd24).

Use from Cursor chat or the terminal. Same architecture as Timelog / Flyway / Caffeine / Notepad++ MCP packages.

Full documentation: docs/WIKI.md

How it works (30 seconds)

You (chat or CLI)
  → workspace-build-mcp
  → scripts/workspace-build.ps1
  → ng build + npm link

Git:
  → scripts/workspace-git.ps1 → mhdd24 push | smart-commit

Configure WORKSPACE_ROOT + alias env vars
Say "build and link core" (or run the .ps1)
Use mhdd24 helpers for commit/push when needed

Prerequisites

Requirement	Notes
Node.js 18+	MCP server
Windows	PowerShell scripts
Angular CLI (`ng`)	On PATH
npm	On PATH
mhdd24-cli	`npm i -g mhdd24-cli` for git tools

Install

Option A — npm (after publish)

npm install -g @mhdd_24/workspace-build-mcp

Option B — npx

npx @mhdd_24/workspace-build-mcp

Option C — clone and build

git clone https://github.com/Mhdd-24/Workspace-Build-MCP.git
cd Workspace-Build-MCP
npm install
npm run build
node dist/index.js

Also install the GitHub helper CLI:

npm i -g mhdd24-cli

Configure Cursor

Edit ~/.cursor/mcp.json:

{
  "mcpServers": {
    "workspace-build": {
      "command": "npx",
      "args": ["-y", "@mhdd_24/workspace-build-mcp"],
      "env": {
        "WORKSPACE_ROOT": "C:/path/to/your/workspace",
        "ALIAS_CORE_WS": "FEApp/ClientApp/ui-core-ws",
        "ALIAS_CORE_PROJECT": "ui-core",
        "ALIAS_CORE_DIST": "dist/ui-core",
        "ALIAS_CORE_PACKAGE": "@scope/ui-core",
        "ALIAS_APP_WS": "FEApp/ClientApp/ui-app-ws/ui-app"
      }
    }
  }
}

Local development:

"command": "node",
"args": ["C:/path/to/workspace-build-mcp/dist/index.js"]

Reload MCP after saving.

Environment variables

Variable	Required	Purpose
`WORKSPACE_ROOT`	Yes	Monorepo / workspace root
`ALIAS_CORE_WS`	Yes (for build)	Library workspace (relative to root or absolute)
`ALIAS_CORE_PROJECT`	No	Angular project name (default `ui-core`)
`ALIAS_CORE_DIST`	No	Dist folder under library ws (default `dist/<project>`)
`ALIAS_CORE_PACKAGE`	No	npm package name to link (default `@scope/<project>`)
`ALIAS_APP_WS`	Yes (for link)	Consumer app path
`GIT_CWD`	No	cwd for mhdd24 (defaults to `WORKSPACE_ROOT`)

Aliases: core → library settings; app → consumer app path.

Tools

Tool	Purpose
`ws_status`	Config + `ng` / `npm` / `mhdd24` availability
`ws_list_aliases`	Resolved alias paths
`ws_build_link`	Build library + link into app
`ws_build_only`	Build library only
`ws_git_push`	`mhdd24 push "<message>"`
`ws_git_smart_commit`	`mhdd24 smart-commit`

Chat examples

"List workspace build aliases"
"Build and link core into the app"
"Build core only"
"Push with mhdd24: chore update link"

Terminal

cd path\to\Workspace-Build-MCP
.\scripts\workspace-build.ps1 `
  -LibraryWs "C:\ws\FE\ui-core-ws" `
  -AppWs "C:\ws\FE\ui-app" `
  -NgProject "ui-core" `
  -DistRel "dist\ui-core" `
  -PackageName "@scope/ui-core"

License

ISC

@mhdd_24/workspace-build-mcp