MCP Angular Cli

🚀 Angular CLI MCP Server 🅰️

Angular CLI MCP Server 是一個模型上下文協議（Model Context Protocol）服務器，它為 Angular CLI 和工作區提供自動化能力。該服務器允許大語言模型（LLMs）和智能代理與 Angular 項目進行交互，能通過 Angular CLI 生成組件、服務，添加包，創建新的工作區以及運行自定義架構目標。

🚀 快速開始

本服務器可直接運行，也可作為自定義 MCP 服務器集成到您的代理或工具中，以下是詳細的使用步驟和配置示例。

✨ 主要特性

• 通過運行 ng generate 命令來搭建 Angular 構件（如組件、服務等）。
• 運行 ng add 命令，為您的 Angular 工作區添加包。
• 運行 ng new 命令，創建新的 Angular 工作區。
• 運行 ng run 命令，執行自定義架構目標。
• 運行 ng update 命令，更新 Angular 包及其依賴。
• 以上所有操作均通過模型上下文協議（MCP）實現，便於與代理或大語言模型集成。

📦 安裝指南

您可以使用 npm 全局安裝此包：

npm install -g @talzach/mcp-angular-cli

或者在您的項目中本地安裝：

npm install --save-dev @talzach/mcp-angular-cli

💻 使用示例

基礎用法

您可以直接運行服務器：

npx @talzach/mcp-angular-cli

高級用法

如果您想將其作為自定義 MCP 服務器集成到您的代理或工具中，可按如下方式配置：

示例 MCP 配置

{
  "mcpServers": {
    "angular-cli": {
      "command": "npx",
      "args": ["-y", "@talzach/mcp-angular-cli"]
    }
  }
}

工具使用示例

• 生成組件：

{
  "schematic": "component",
  "name": "my-component",
  "appRoot": "/absolute/path/to/your/angular/project"
}

• 添加包：

{
  "package": "@angular/material",
  "appRoot": "/absolute/path/to/your/angular/project"
}

• 創建新工作區：

{
  "name": "my-workspace",
  "directory": "/absolute/path/to/where/you/want/it"
}

• 運行自定義架構目標：

{
  "target": "app:build:production",
  "appRoot": "/absolute/path/to/your/angular/project"
}

📚 詳細文檔

發佈到 npm

若要將此包的新版本發佈到 npm，可運行以下命令：

npm run publish-npm

此命令將自動構建項目，並將其作為公共包發佈。

開發

如果您想在本地測試或開發此服務器，需要將 MCP 服務器配置指向本地構建輸出。在構建項目（例如使用 npm run build）後，將您的 MCP 服務器文件（例如 .mcp.json 或類似文件）配置為使用本地的 dist/index.js 文件：

{
  "angular-cli": {
    "command": "node",
    "args": ["/path/to/your/mcp-angular-cli/dist/index.js"]
  }
}

如果您覺得這個倉庫有用，請給它點個星！