Azure DevOps 工作项 MCP 服务器

使用说明内容(Markdown格式)

项目简介

  • 这是一个基于 MCP 的服务器实现,专注于 Azure DevOps 工作项的托管、查询、创建、更新以及评论等操作。通过标准化的 MCP 接口,向大型语言模型提供统一的数据访问和外部功能调用能力,并内置 HTML 转 Markdown 的描述渲染能力,提升在 AI 助手中的可读性和响应效率。

主要功能点

  • 提供六个核心工具:
    • get_work_item:按 ID 获取单个工作项及其关键字段
    • list_work_items:通过 WIQL 查询检索工作项列表
    • list_my_work_items:获取当前用户分配的活动中工作项
    • create_work_item:创建新工作项
    • update_work_item:更新现有工作项的字段
    • add_comment:向工作项添加评论
  • 支持将工作项描述等 HTML 字段转换为 Markdown,减少 token 的使用并提升AI响应时间
  • 服务器端实现会话管理和能力声明,支持通过不同传输协议(如 stdio、SSE、WebSocket 等)进行通信(当前示例以 stdio 为默认传输)
  • 集成对 Azure DevOps REST API 的封装,提供易于测试的客户端接口(通过 mock 实现和集成测试覆盖)
  • 提供灵活的输入类型(FlexID、FlexFloat 等),支持数字、字符串以及引用形式的工作项 ID

安装步骤

  • 获取源码并编译
    • git clone https://github.com/markis/azure-devops-mcp.git
    • go build -o azure-devops-mcp ./cmd/azure-devops-mcp
  • 运行服务器
    • 直接执行二进制:
      • 在终端执行 ./azure-devops-mcp
    • 或者从源码运行(需要已安装 Go):
      • go run ./cmd/azure-devops-mcp
  • 环境配置(启动前需要设置以下环境变量):
    • AZURE_DEVOPS_ORG_URL:Azure DevOps 组织的 URL,例如 https://dev.azure.com/your-org
    • AZURE_DEVOPS_PAT:用于认证的 Personal Access Token(PAT),需要具备工作项的读写权限
    • AZURE_DEVOPS_PROJECT:默认的 Azure DevOps 项目名
  • 运行后,服务器会按 MCP 规范对外提供接口,供 MCP 客户端(如 Claude、OpenCode 等)连接使用

服务器配置(给 MCP 客户端的配置示例说明)

  • MCP 客户端需要的配置信息通常包含 server name、启动命令及参数等,用于将该 MCP 服务器接入到客户端的“服务器列表”中。以下信息描述性注释可帮助理解,实际你应在你的 MCP 客户端配置文件中填入 JSON 配置(不是代码块)。示例注释如下: { // 服务器名称,与客户端配置中的键名对应 "serverName": "azure-devops", // 启动该 MCP 服务器的命令(绝对路径或可执行名) "command": "/path/to/azure-devops-mcp", // 启动参数,若无可留空 "args": [], // 环境变量,用于服务器启动时注入运行时所需参数 "env": { "AZURE_DEVOPS_ORG_URL": "https://dev.azure.com/your-org", "AZURE_DEVOPS_PAT": "your-personal-access-token", "AZURE_DEVOPS_PROJECT": "your-project-name" } } 说明
  • 上述配置用于将服务器接入到客户端的 MCP 调用系统。MCP 客户端只是需要知道如何启动服务以及传入的必要环境变量,不需要嵌入任何业务逻辑。

基本使用方法

  • 启动后,客户端通过 MCP 标准的 JSON-RPC 形式向服务器发送请求,服务器返回 JSON-RPC 响应。
  • 常用操作包括:请求获取、查询、创建、更新工作项以及添加评论等工具调用。客户端应按 MCP 的调用规范构造请求参数,解析服务器返回的结果文本或结构化数据。
  • 服务器默认使用标准输入输出传输(stdio),也可在需要时切换为其他传输协议(如 SSE、WebSocket)以支撑不同部署场景。

关键词 Azure DevOps, 工作项, WIQL, 自动化, 集成测试

分类ID 6

服务器信息