Azure DevOps MCP Server

Azure DevOps MCP Server

site icon
2025.04.17 0
TypeScript项目管理代码仓库管理自动化测试管理持续集成/持续部署开发效率交流协作
mcp-server-azdo 是一个针对 Azure DevOps Services API 的 MCP 服务器,提供文件操作、仓库管理、搜索功能等核心能力。该服务支持自动分支创建、完善的错误处理、Git 历史保留、批量操作和高级搜索等特性,适用于团队协作开发、项目管理、代码仓库维护等场景。
View on GitHub

Overview

基本能力

产品定位

mcp-server-azdo 是一个专门为 Azure DevOps Services API 设计的 MCP 服务器,旨在简化开发团队在 Azure DevOps 平台上的操作流程,提高开发效率。

核心功能

  • 自动分支创建:在创建/更新文件或推送更改时自动创建不存在的分支
  • 完善的错误处理:为常见问题提供清晰的错误信息
  • Git 历史保留:操作保持正确的 Git 历史记录,无需强制推送
  • 批量操作:支持单文件和批量文件操作
  • 高级搜索:支持搜索代码、工作项、拉取请求和用户

适用场景

  • 团队协作开发
  • 项目管理
  • 代码仓库维护
  • 自动化测试管理
  • 持续集成/持续部署(CI/CD)

工具列表

  1. create_or_update_file:在仓库中创建或更新单个文件
  2. push_files:在单个提交中推送多个文件
  3. search_repositories:搜索 Azure DevOps 仓库
  4. create_repository:创建新的 Azure DevOps 仓库
  5. get_file_contents:获取文件或目录内容
  6. create_work_item:创建工作项(问题、任务等)
  7. create_pull_request:创建新的拉取请求
  8. list_dashboards:列出项目中的仪表板
  9. list_queries:列出项目中的查询
  10. list_test_cases:列出项目中的测试用例
  11. list_test_plans:列出项目中的测试计划
  12. list_artifacts:列出项目中的工件
  13. list_projects:列出组织中的所有项目
  14. get_project:获取特定项目的详细信息
  15. create_project:创建新项目
  16. update_project:更新现有项目
  17. delete_project:删除项目
  18. list_process_templates:列出所有流程模板
  19. get_process_template:获取流程模板详细信息
  20. list_iterations:列出项目中的所有迭代
  21. get_iteration:获取特定迭代的详细信息
  22. create_iteration:在项目中创建新迭代
  23. update_iteration:更新迭代
  24. delete_iteration:删除迭代
  25. list_areas:列出项目中的所有区域
  26. get_area:获取特定区域的详细信息
  27. create_area:在项目中创建新区域
  28. update_area:更新区域
  29. delete_area:删除区域

常见问题解答

  1. 如何获取访问令牌?
  2. 创建 Azure DevOps 个人访问令牌,并选择适当的权限范围(如代码、工作项、测试管理等)
  3. 如何与 Claude Desktop 一起使用?
  4. claude_desktop_config.json 中添加相应的配置
  5. 如何构建 Docker 镜像?
  6. 使用 docker build -t mcp/azure-devops -f src/azure-devops/Dockerfile . 命令

使用教程

使用依赖

  1. 创建 Azure DevOps 个人访问令牌:
  2. 访问 Personal access tokens
  3. 选择所需的权限范围(如 Code, Work Items, Test Management)
  4. 复制生成的令牌

安装教程

Docker 安装

{
  "mcpServers": {
    "azure-devops": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "AZURE_DEVOPS_PERSONAL_ACCESS_TOKEN",
        "mcp/azure-devops"
      ],
      "env": {
        "AZURE_DEVOPS_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

NPX 安装

{
  "mcpServers": {
    "azure-devops": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-azure-devops"
      ],
      "env": {
        "AZURE_DEVOPS_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

调试方式

  1. 构建 Docker 镜像:
docker build -t mcp/azure-devops -f src/azure-devops/Dockerfile .
  1. 运行容器并检查日志输出
  2. 验证 API 调用是否返回预期结果

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。