项目简介
Ares DevOps MCP Server 是一个基于 Model Context Protocol (MCP) 构建的后端服务,旨在为 LLM (大型语言模型) 应用提供与 Azure DevOps 集成的能力。它允许 LLM 客户端通过标准化的 MCP 协议,安全地访问和操作 Azure DevOps 中的资源和功能,例如代码仓库、分支、Pull Request 和 CI/CD 流水线。
主要功能点
- Azure DevOps 集成: 无缝连接 Azure DevOps,支持对代码仓库、Pull Request 和流水线进行操作。
- 资源管理: 支持代码仓库和分支的管理,例如创建仓库、列出分支、获取提交历史等。
- 工具执行: 提供一系列工具,允许 LLM 客户端创建和管理 Pull Request,添加 Pull Request 评论,触发和监控 CI/CD 流水线等。
- 安全可靠: 通过个人访问令牌 (PAT) 进行身份验证,安全地访问 Azure DevOps 资源。
- 易于配置: 支持多种 MCP 客户端 (如 Cline, Cursor, Claude Desktop),提供详细的配置指南。
安装步骤
-
安装 Node.js 和 npm: 确保你的环境中已安装 Node.js (v14 或更高版本) 和 npm 包管理器。
-
安装 Ares DevOps MCP Server: 可以通过 npm 的 npx 命令直接运行,无需全局安装。
npx -y ares-devops-mcp@latest或者,如果使用 Smithery 客户端,可以使用 Smithery CLI 进行安装:
npx -y @smithery/cli install @ares-devops/mcp --client claude
服务器配置
MCP 客户端需要配置 MCP 服务器的启动命令才能连接到 Ares DevOps MCP Server。以下是针对不同 MCP 客户端的配置示例,配置信息为 JSON 格式:
1. Cline (VS Code 扩展) 配置:
在 Cline MCP 设置文件 'cline_mcp_settings.json' 中添加以下配置:
{ "mcpServers": { "ares-devops-mcp": { // 服务器名称,用户自定义 "command": "npx", // 启动命令,使用 npx 运行 npm 包 "args": ["-y", "ares-devops-mcp@latest"], // 命令参数,-y 表示自动确认安装,ares-devops-mcp@latest 指定要运行的 npm 包 "env": { // 环境变量配置,用于传递 Azure DevOps 凭据 "AZURE_DEVOPS_ORG": "your-organization", // Azure DevOps 组织名称,请替换为你的组织名称 "AZURE_DEVOPS_PROJECT": "your-project", // Azure DevOps 项目名称,请替换为你的项目名称 "AZURE_DEVOPS_PAT": "your-pat-token" // Azure DevOps 个人访问令牌 (PAT),请替换为你的 PAT }, "disabled": false, // 是否禁用该服务器,false 表示启用 "autoApprove": [] // 自动批准的工具列表,默认为空 } } }
2. Cursor (代码编辑器) 配置:
在 Cursor 的 MCP Servers 设置中,添加新的 MCP Server,并填写以下信息:
- Name: 'ares-devops-mcp' (或其他自定义名称)
- Type: 'command'
- Command:
请务必将 'your-org', 'your-project', 'your-pat' 替换为你的 Azure DevOps 组织、项目和个人访问令牌。env AZURE_DEVOPS_ORG=your-org AZURE_DEVOPS_PROJECT=your-project AZURE_DEVOPS_PAT=your-pat npx -y ares-devops-mcp@latest
3. Claude Desktop App 配置:
在 Claude Desktop App 的配置文件 'claude_desktop_config.json' 中添加以下配置:
{ "mcpServers": { "ares-devops-mcp": { // 服务器名称,用户自定义 "command": "npx", // 启动命令,使用 npx 运行 npm 包 "args": ["-y", "ares-devops-mcp@latest"], // 命令参数,-y 表示自动确认安装,ares-devops-mcp@latest 指定要运行的 npm 包 "env": { // 环境变量配置,用于传递 Azure DevOps 凭据 "AZURE_DEVOPS_ORG": "your-organization", // Azure DevOps 组织名称,请替换为你的组织名称 "AZURE_DEVOPS_PROJECT": "your-project", // Azure DevOps 项目名称,请替换为你的项目名称 "AZURE_DEVOPS_PAT": "your-pat-token" // Azure DevOps 个人访问令牌 (PAT),请替换为你的 PAT } } } }
基本使用方法
成功配置并启动 Ares DevOps MCP Server 后,在 MCP 客户端 (如 Claude Desktop App) 中,你可以使用自然语言指令调用 Azure DevOps 的功能。
示例:
- 创建代码仓库: 在对话框中输入 'Create a new repository named "my-project" in Azure DevOps.'
- 创建 Pull Request: 输入 'Create a pull request from "feature-branch" to "main" in repository "my-project" with title "New Feature" and description "Adding new functionality".'
- 列出流水线: 输入 'List all available pipelines in the project.'
- 获取提交历史: 输入 'Get the commit history for the "main" branch in repository "my-project".'
客户端会将这些自然语言指令转换为对 MCP 服务器的工具调用,服务器执行相应的 Azure DevOps 操作,并将结果返回给客户端。
注意: 首次使用时,Claude Desktop App 需要完全关闭并重新打开才能识别到新配置的 MCP 服务器。在 Claude Desktop App 的左下角,如果看到锤子图标,则表示 MCP 工具已可用。
信息
分类
开发者工具