@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