@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

1. Configure WORKSPACE_ROOT + alias env vars
2. Say "build and link core" (or run the .ps1)
3. 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