Azure DevOps MCP 服务器

一个提供与 Azure DevOps 集成的 MCP（Model Context Protocol）服务器，允许 AI 助手与 Azure DevOps 工作项、拉取请求和维基页面进行交互。

特性

• 工作项管理（创建、列出、获取）
• 拉取请求操作（创建、列出、获取、评论、差异）
• 维基页面管理（创建、编辑）

设置

1. 安装依赖项：

npm install

1. 配置环境变量（创建一个 .env 文件）：

AZURE_DEVOPS_ORG_URL=https://dev.azure.com/your-org
AZURE_DEVOPS_PAT=your-personal-access-token
AZURE_DEVOPS_PROJECT=default-project
AZURE_DEVOPS_REPOSITORY=default-repo

1. 构建服务器：

npm run build

安装

将服务器配置添加到您的 MCP 设置中：

对于 VSCode

在 macOS/Linux 上

添加到 ~/.vscode/cline_mcp_settings.json 或 Cursor/Roo 的等效文件中：

{
  "mcpServers": {
    "azure-devops": {
      "command": "node",
      "args": ["/path/to/azure-devops-mcp/build/index.js"],
      "env": {
        "AZURE_DEVOPS_ORG_URL": "your-org-url",
        "AZURE_DEVOPS_PAT": "your-pat",
        "AZURE_DEVOPS_PROJECT": "your-project",
        "AZURE_DEVOPS_REPOSITORY": "your-repo"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

在 Windows 上

添加到 %USERPROFILE%\.vscode\cline_mcp_settings.json 或 Cursor/Roo 的等效文件中：

{
  "mcpServers": {
    "azure-devops": {
      "command": "node",
      "args": ["C:/path/to/azure-devops-mcp/build/index.js"],
      "env": {
        "AZURE_DEVOPS_ORG_URL": "your-org-url",
        "AZURE_DEVOPS_PAT": "your-pat",
        "AZURE_DEVOPS_PROJECT": "your-project",
        "AZURE_DEVOPS_REPOSITORY": "your-repo"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

可用工具

工作项

list_work_items

列出项目中的工作项。

{
  "project": string,        // Required
  "types"?: string[],      // Optional: Filter by work item types
  "states"?: string[],     // Optional: Filter by states
  "assignedTo"?: string    // Optional: Filter by assigned user
}

get_work_item

获取特定工作项的详细信息。

{
  "project": string,       // Required
  "id": number            // Required: Work item ID
}

create_work_item

创建新的工作项。

{
  "project": string,       // Required
  "type": string,         // Required: e.g., "Task", "Bug"
  "title": string,        // Required
  "description"?: string, // Optional
  "assignedTo"?: string  // Optional
}

拉取请求

list_pull_requests

列出仓库中的拉取请求。

{
  "status"?: "active" | "completed" | "abandoned"  // Optional
}

get_pull_request

获取特定拉取请求的详细信息。

{
  "pullRequestId": number  // Required
}

create_pull_request

创建新的拉取请求。

{
  "title": string,         // Required
  "description": string,   // Required
  "sourceBranch": string, // Required
  "targetBranch": string, // Required
  "reviewers"?: string[]  // Optional: Array of reviewer email addresses
}

create_pull_request_comment

向拉取请求添加评论。

{
  "pullRequestId": number,                                      // Required
  "content": string,                                           // Required
  "threadId"?: number,                                         // Optional: For replies
  "filePath"?: string,                                         // Optional: For file comments
  "lineNumber"?: number,                                       // Optional: For line comments
  "status"?: "active"|"fixed"|"pending"|"wontfix"|"closed"    // Optional: Thread status
}

get_pull_request_diff

获取拉取请求的差异。

{
  "pullRequestId": number,  // Required
  "filePath"?: string,     // Optional: Specific file to get diff for
  "iterationId"?: number   // Optional: Specific iteration to get diff for
}

维基

create_wiki_page

创建新的维基页面。

{
  "project": string,    // Required
  "wiki": string,      // Required
  "path": string,      // Required
  "content": string    // Required
}

edit_wiki_page

编辑现有的维基页面。

{
  "project": string,    // Required
  "wiki": string,      // Required
  "path": string,      // Required
  "content": string,   // Required
  "etag": string       // Required: For concurrency control
}

开发

使用环境变量以开发模式运行：

npm run dev

注意

除非在工具参数中明确指定，否则 project 和 repository 参数将使用来自您的环境配置的默认值。