azure-devops-mcp-server MCP 服务器

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

这是一个基于 TypeScript 的 MCP 服务器，旨在通过 axios 使用 Azure DevOps REST API 与 Azure DevOps 工作项进行交互。

功能

工具

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

• create_work_item: 在 Azure DevOps 中创建新的工作项（例如用户故事、Bug、任务）。
  • 必要参数：type (类型), title (标题)。
  • 可选参数：description (描述), areaPath (区域路径), iterationPath (迭代路径), assignedTo (指派对象), tags (标签)。
• get_work_item_details: 根据 ID 获取 Azure DevOps 工作项的详细信息。
  • 必要参数：id (工作项 ID)。
• update_work_item: 更新现有 Azure DevOps 工作项的字段（例如状态、指派对象）。
  • 必要参数：id (工作项 ID), updates (包含要更新字段和值的对象)。
  • 可选参数：comment (更新评论)。
• search_work_items: 搜索 Azure DevOps 工作项。可依项目、类型、标题或 ID 进行筛选。
  • 可选参数：query (搜索关键字), projectName (项目名称), workItemType (工作项目类型)。
• list_projects: 列出 Azure DevOps 组织中的所有项目。
• get_project_details: 根据项目 ID 或名称获取 Azure DevOps 项目的详细信息。
  • 必要参数：projectIdOrName (项目 ID 或名称)。

开发

安装依赖项:

npm install

构建服务器:

npm run build

用于自动重建的开发:

npm run watch

安装

要与 Claude Desktop 一起使用，请添加服务器配置：

在 MacOS 上: ~/Library/Application Support/Claude/claude_desktop_config.json 在 Windows 上: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "azure-devops-mcp-server": {
      "command": "C:\\Program Files\\nodejs\\node.exe", // 或您的 Node.js 路径
      "args": [
        "C:\\Tools\\Cline\\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 替换为具有读写工作项权限的有效个人访问令牌 (PAT)。

调试

由于 MCP 服务器通过 stdio 进行通信，因此调试可能具有挑战性。 我们建议使用 MCP Inspector，它作为包脚本提供：

npm run inspector

Inspector 将提供一个 URL 以访问浏览器中的调试工具。