Azure DevOps MCP 服务器，适用于 Cline

此模型上下文协议 (MCP) 服务器提供与 Azure DevOps 的集成，允许 Cline 与 Azure DevOps 服务交互。

前提条件

• Node.js (v20 LTS 或更高版本)
• npm (随 Node.js 一起提供)
• Cline 安装
• 具有访问令牌的 Azure DevOps 帐户

安装

通过 Smithery 安装

要通过 Smithery 自动安装适用于 Claude Desktop 的 Azure DevOps 服务器：

npx -y @smithery/cli install @stefanskiasan/azure-devops-mcp-server --client claude

手动安装

1. 克隆此存储库：

git clone https://github.com/stefanskiasan/azure-devops-mcp-server.git
cd azure-devops-mcp-server

2. 安装依赖项：

npm install

3. 构建服务器：

npm run build

注意：构建输出（build/ 目录）未包含在版本控制中。克隆存储库后，必须运行构建命令。

配置

1. 获取 Azure DevOps 个人访问令牌 (PAT)

1. 转到 Azure DevOps 并登录
2. 单击右上角的个人资料图片
3. 选择“安全”
4. 单击“新建令牌”
5. 为令牌命名并选择所需的范围：
   • Code (read, write) - 用于拉取请求操作
   • Work Items (read, write) - 用于工作项管理
   • Build (read, execute) - 用于管道操作
   • Wiki (read, write) - 用于 Wiki 操作
   • Project and Team (read) - 用于项目和看板信息
6. 复制生成的令牌

2. 配置 Cline MCP 设置

将服务器配置添加到 Cline MCP 设置文件：

• 对于 VSCode 扩展：%APPDATA%/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json
• 对于 Claude 桌面应用程序：%LOCALAPPDATA%/Claude/claude_desktop_config.json

将以下配置添加到 mcpServers 对象：

{
  "mcpServers": {
    "azure-devops": {
      "command": "node",
      "args": ["/absolute/path/to/azure-devops-server/build/index.js"],
      "env": {
        "AZURE_DEVOPS_ORG": "your-organization",
        "AZURE_DEVOPS_PAT": "your-personal-access-token",
        "AZURE_DEVOPS_PROJECT": "your-project-name"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

替换以下值：

• /absolute/path/to/azure-devops-server: 克隆此存储库的绝对路径
• your-organization: 您的 Azure DevOps 组织名称
• your-project-name: 您的 Azure DevOps 项目名称
• your-personal-access-token: 您在步骤 1 中生成的 PAT

可用工具

工作项

• get_work_item: 按 ID 获取工作项
• list_work_items: 使用 WIQL 查询工作项
• create_work_item: 创建新的工作项（Bug、Task、User Story）
• update_work_item: 更新现有工作项

看板

• get_boards: 获取项目中可用的看板

管道

• list_pipelines: 列出项目中的所有管道
• trigger_pipeline: 执行管道

拉取请求

• list_pull_requests: 列出拉取请求
• create_pull_request: 创建新的拉取请求
• update_pull_request: 更新拉取请求
• get_pull_request: 获取拉取请求详细信息

Wiki

• get_wikis: 列出项目中的所有 Wiki
• get_wiki_page: 获取 Wiki 页面
• create_wiki: 创建新的 Wiki
• update_wiki_page: 创建或更新 Wiki 页面

项目

• list_projects: 列出 Azure DevOps 组织中的所有项目

验证

1. 添加配置后，重新启动 Cline（或 VSCode）
2. Azure DevOps MCP 服务器现在应列在 Cline 的功能中
3. 您可以使用 MCP Inspector 验证安装：

npm run inspector

故障排除

1. 如果服务器未连接：

   • 检查 MCP 设置中的路径是否正确
   • 验证您的 Azure DevOps 凭据
   • 检查 Cline 日志中是否有任何错误消息

2. 如果您收到身份验证错误：

   • 验证您的 PAT 是否已过期
   • 确保 PAT 具有所有必需的范围
   • 仔细检查组织和项目名称

3. 对于其他问题：

   • 运行 inspector 工具以验证服务器是否正常工作
   • 检查服务器日志中是否有任何错误消息

开发

要修改或扩展服务器：

1. 在 src 目录中进行更改
2. 运行 npm run watch 进行开发
3. 准备就绪后，使用 npm run build 进行构建
4. 使用 inspector 进行测试：npm run inspector

许可证

MIT 许可证 - 有关详细信息，请参见 LICENSE