Azure DevOps MCP Server for Cline

此 Model Context Protocol (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. 为您的令牌命名并选择所需的范围：
   • 代码（读取、写入） - 用于拉取请求操作
   • 工作项（读取、写入） - 用于工作项管理
   • 构建（读取、执行） - 用于管道操作
   • 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: 您在第一步生成的 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 检查器验证安装：

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