Azure DevOps MCP 服务器 for 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

1. 安装依赖项：

npm install

1. 构建服务器：

npm run build

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

配置

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

1. 前往 Azure DevOps 并登录
2. 点击右上角的个人资料图片
3. 选择“安全”
4. 点击“新令牌”
5. 为令牌命名并选择所需的范围：
   • 代码（读取、写入） - 用于拉取请求操作
   • 工作项（读取、写入） - 用于工作项管理
   • 构建（读取、执行） - 用于管道操作
   • Wiki（读取、写入） - 用于 Wiki 操作
   • 项目和团队（读取） - 用于项目和看板信息
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、任务、用户故事）
• 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. 对于其他问题：

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

开发

要修改或扩展服务器：

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

许可证

MIT 许可证 - 详情请参阅 LICENSE