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"]
  }
}

如果您觉得这个仓库有用，请给它点个星！