Azure DevOps MCP Server for Cline

适用于 Cline 的 Azure DevOps MCP 服务

此模型上下文协议（MCP）服务提供与 Azure DevOps 的集成，让 Cline 能够与 Azure DevOps 服务交互。

前置条件

• Node.js（v20 LTS 或更高版本）
• npm（随 Node.js 一同安装）
• 已安装 Cline
• 拥有访问令牌的 Azure DevOps 帐户

安装

手动安装

1. 克隆此仓库：

git clone https://github.com/MananShahTR/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/saoudrizwan.claude-dev/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