azure-devops-mcp-server

🚀 Azure DevOps MCP 服务器

通过自然语言，能更便捷地与 Azure DevOps 进行交互。此项目是一个基于 TypeScript 的 MCP 服务器，借助 axios 调用 Azure DevOps REST API 来管理 Azure DevOps 工作项。

🚀 快速开始

本服务器可帮助你通过自然语言更方便地与 Azure DevOps 互动，以下将为你介绍其功能、安装、使用、调试等方面的内容。

✨ 主要特性

工具

此服务器提供了以下工具来管理 Azure DevOps 资源：

• create_work_item：在 Azure DevOps 中创建新的工作项（例如用户故事、Bug、任务）。

  • 必要参数：type（类型）、title（标题）。
  • 可选参数：projectName（项目名称，默认为当前项目）、description（描述）、severity（严重性）、priority（优先级）、state（状态）、assignee（分配给）、tags（标签列表）。

• query_work_items：查询 Azure DevOps 项目中的工作项。

  • 必要参数：projectName（项目名称，默认为当前项目）、query（查询条件，支持 Azure Query Language）。
  • 返回：匹配的工作项列表。

• update_work_item：更新现有工作项的属性。

  • 必要参数：id（工作项 ID）、fields（需要更新的字段及其值）。

• delete_work_item：删除指定的工作项。

  • 必要参数：id（工作项 ID）。

📦 安装指南

要使用此 MCP 服务器，请按照以下步骤进行安装：

1. 克隆代码库：

   git clone https://github.com/yourusername/azure-devops-mcp-server.git
   cd azure-devops-mcp-server
   

2. 安装依赖项：

   npm install
   

3. 构建服务器：

   npm run build
   

4. （可选）配置开发环境以自动重建：

   npm run watch
   

💻 使用示例

要在 Claude Desktop 中使用此 MCP 服务器，请按照以下步骤进行配置：

Windows 系统

• 打开 %APPDATA%/Claude/claude_desktop_config.json 文件。
• 在 mcpServers 节点下添加以下内容：

  {
    "azure-devops-mcp-server": {
      "command": "C:\\Program Files\\nodejs\\node.exe",
      "args": ["C:\\Tools\\Claude\\MCP\\ azure-devops-mcp-server\\build\\index.js"],
      "env": {
        "AZURE_DEVOPS_ORG_URL": "YOUR_ORG_URL", // 示例：https://dev.azure.com/YourOrganizationName
        "AZURE_DEVOPS_PAT": "YOUR_PERSONAL_ACCESS_TOKEN"
      }
    }
  }
  

• 将 YOUR_ORG_URL 替换为您的 Azure DevOps 组织 URL，将 YOUR_PERSONAL_ACCESS_TOKEN 替换为您自己的个人访问令牌。

MacOS 系统

• 打开 ~/Library/Application Support/Claude/claude_desktop_config.json 文件。
• 在 mcpServers 节点下添加以下内容：

  {
    "azure-devops-mcp-server": {
      "command": "/usr/local/bin/node",
      "args": ["C:\\Tools\\Claude\\MCP\\ azure-devops-mcp-server\\build\\index.js"],
      "env": {
        "AZURE_DEVOPS_ORG_URL": "YOUR_ORG_URL", // 示例：https://dev.azure.com/YourOrganizationName
        "AZURE_DEVOPS_PAT": "YOUR_PERSONAL_ACCESS_TOKEN"
      }
    }
  }
  

• 将 YOUR_ORG_URL 替换为您的 Azure DevOps 组织 URL，将 YOUR_PERSONAL_ACCESS_TOKEN 替换为您自己的个人访问令牌。

📚 详细文档

调试

由于 MCP 服务器通过标准输入输出进行通信，调试可能具有挑战性。我们建议使用 MCP 检查器，这是一个作为包脚本提供的工具：

npm run inspector

检查器将在浏览器中提供一个调试工具的 URL。

参考资料

• Azure DevOps REST API 参考文档