Azure DevOps MCP 服务器

通过自然语言更方便地与 Azure DevOps 互动。

这是一个基于 TypeScript 的 MCP 服务器，使用 axios 调用 Azure DevOps REST API 来管理 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 参考文档