ado-mcp-server

ado-mcp-server

一个用于 Azure DevOps 的模型上下文协议（MCP）服务。

概述

此项目实现了一个旨在与 Azure DevOps 集成的 MCP 服务。该服务使用 @modelcontextprotocol/sdk 构建，并支持通过模块化工具注册系统进行扩展。

功能

• 使用官方 SDK 实现 MCP 服务
• 可扩展的架构，用于注册项目和工作项工具
• 全面支持 Azure DevOps 工作项跟踪（WIT）REST API 端点（创建、获取、更新、删除、列出、查询、批处理、修订、评论、附件、关系）
• 通过 STDIO 运行，以便与其他系统集成

入门指南

先决条件

• Node.js（推荐使用 16+ 版本）
• npm

安装

克隆代码仓库并安装依赖项：

git clone https://github.com/dmedellin/ado-mcp-server.git
cd ado-mcp-server
npm install

用法

启动 MCP 服务：

npm start

服务将通过 STDIO 运行，并可与兼容的客户端集成。

测试

你可以使用 Model Context Protocol Inspector 测试此服务：

npx @modelcontextprotocol/inspector

项目结构

• index.js - 入口点；初始化并运行 MCP 服务。
• features/ - 用于注册项目和工作项工具的目录。

脚本

• npm start - 启动 MCP 服务。
• npm test -（目前尚未实现。）

配置

基本用法无需其他配置。你可以在 features 目录中添加新工具来扩展功能。

依赖项

• @modelcontextprotocol/sdk
• zod

许可证

ISC

---

此项目与 Microsoft 或 Azure DevOps 无关。

工具

• linkWorkItems — 链接两个 Azure DevOps 工作项（例如，父子项、相关项等）。

  • 输入：
    • sourceId（number/string）：源工作项的 ID（例如，父子链接中的子项）。
    • targetId（number/string）：目标工作项的 ID（例如，父子链接中的父项）。
    • linkType（string，可选）：链接类型（父子链接的默认值：System.LinkTypes.Hierarchy-Forward）。
    • comment（string，可选）：链接操作的可选评论。
  • **权限：**需要在 Azure DevOps 项目中编辑工作项的权限。
  • 示例：

    {
      "sourceId": 123,
      "targetId": 456,
      "linkType": "System.LinkTypes.Hierarchy-Forward"
    }
    

• unlinkWorkItems — 移除两个 Azure DevOps 工作项之间的链接（例如，父子项、相关项）。

  • 输入：
    • sourceId（number/string）：源工作项的 ID（持有该链接的工作项）。
    • targetId（number/string）：目标工作项的 ID（被链接到的工作项）。
    • linkType（string，可选）：要移除的链接类型（父子链接的默认值：System.LinkTypes.Hierarchy-Forward）。
  • **权限：**需要在 Azure DevOps 项目中编辑工作项的权限。
  • 示例：

    {
      "sourceId": 123,
      "targetId": 456,
      "linkType": "System.LinkTypes.Hierarchy-Forward"
    }
    

• 如需了解更多链接类型，请参阅 Azure DevOps 文档。