Azure DevOps MCP Server for Cline

此模型上下文协议（MCP）服务器提供了与Azure DevOps的集成，允许Cline与Azure DevOps服务进行交互。

预备条件

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

安装

通过Smithery安装

要通过Smithery自动安装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. 给你的令牌命名并选择所需的范围：
   • 代码（读取，写入） - 用于拉取请求操作
   • 工作项（读取，写入） - 用于工作项管理
   • 构建（读取，执行） - 用于管道操作
   • 维基（读取，写入） - 用于维基操作
   • 项目和团队（读取） - 用于项目和看板信息
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：获取拉取请求详情

维基

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

项目

• 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