Azure DevOps MCP Server 使用说明

项目简介

Azure DevOps MCP Server 是一个 MCP 服务器的实现，它充当 LLM 客户端（如 Cline）与 Azure DevOps 之间的桥梁。通过该服务器，LLM 客户端可以调用 Azure DevOps 的各项功能，例如：

查询和管理 Azure DevOps 中的工作项（Work Items）。
查看和管理项目看板（Boards）。
触发和管理构建流水线（Pipelines）。
管理代码仓库的拉取请求（Pull Requests）。
访问和编辑项目 Wiki。
获取项目信息（Projects）。

这使得 LLM 应用能够利用 Azure DevOps 强大的项目管理和 DevOps 功能，实现更智能化的软件开发和运维流程自动化。

主要功能点

工具集成: 提供了一系列工具，允许 LLM 客户端与 Azure DevOps 服务进行交互，包括工作项管理、看板信息查询、流水线触发、拉取请求管理、Wiki 操作以及项目信息获取。
标准化接口: 基于 Model Context Protocol 标准构建，确保与兼容 MCP 协议的 LLM 客户端（如 Cline）的无缝集成。
易于安装和配置: 提供了通过 Smithery 自动安装和手动安装两种方式，配置步骤清晰，易于上手。
可扩展性: 项目结构清晰，易于开发者扩展和添加更多 Azure DevOps 工具或功能。

安装步骤

通过 Smithery 自动安装 (推荐 Claude Desktop 用户):

确保已安装 Cline 客户端（如 Claude Desktop）。

打开终端，运行以下命令，即可自动安装 Azure DevOps MCP Server：

npx -y @smithery/cli install @stefanskiasan/azure-devops-mcp-server --client claude

手动安装:

克隆仓库:

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

安装依赖:
```
npm install
```
构建服务器:
```
npm run build
```

服务器配置

获取 Azure DevOps Personal Access Token (PAT):
- 登录 Azure DevOps，进入个人设置 -> Personal access tokens。
- 创建新的 PAT，并授予以下权限：
  - 'Code (read, write)'
  - 'Work Items (read, write)'
  - 'Build (read, execute)'
  - 'Wiki (read, write)'
  - 'Project and Team (read)'
- 复制生成的 PAT。
配置 Cline MCP 设置:
- 找到 Cline 客户端的 MCP 配置文件：
  - VSCode 扩展: '%APPDATA%/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json'
  - Claude desktop app: '%LOCALAPPDATA%/Claude/claude_desktop_config.json'
- 在 'mcpServers' 对象中添加以下配置：
```
{
  "mcpServers": {
    "azure-devops": {
      "command": "node",
      "args": ["/absolute/path/to/azure-devops-mcp-server/build/index.js"],
      "env": {
        "AZURE_DEVOPS_ORG": "your-organization",
        "AZURE_DEVOPS_PAT": "your-personal-access-token",
        "AZURE_DEVOPS_PROJECT": "your-project-name"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}
```
参数注释:
- '"azure-devops"': 服务器名称，可以自定义，用于在 Cline 客户端中标识该服务器。
- '"command": "node"': 启动服务器的命令，这里使用 Node.js 运行时。
- '"args": ["/absolute/path/to/azure-devops-mcp-server/build/index.js"]': 启动命令的参数，指向服务器入口文件 'index.js' 的绝对路径。请将 '/absolute/path/to/azure-devops-mcp-server' 替换为你克隆仓库的实际绝对路径。
- '"env"': 环境变量配置，用于服务器运行时读取 Azure DevOps 的连接信息。
  - '"AZURE_DEVOPS_ORG": "your-organization"': 请替换为你的 Azure DevOps 组织名称。
  - '"AZURE_DEVOPS_PAT": "your-personal-access-token"': 请替换为你之前生成的 Azure DevOps PAT。
  - '"AZURE_DEVOPS_PROJECT": "your-project-name"': 请替换为你想要连接的 Azure DevOps 项目名称。
- '"disabled": false': 设置为 'false' 启用该 MCP 服务器。
- '"autoApprove": []': 自动批准的工具列表，默认为空。

基本使用方法

重启 Cline 客户端 (VSCode 或 Claude desktop app)。
验证服务器连接: 在 Cline 客户端中，检查是否已成功检测到 "azure-devops" MCP 服务器及其提供的 capabilities。
使用工具: 在 Cline 客户端中，可以通过自然语言指令或工具调用方式，使用 Azure DevOps MCP Server 提供的工具，例如：
- 查询工作项: 'get_work_item ids: [123, 456]'
- 列出项目流水线: 'list_pipelines'
- 创建拉取请求: 'create_pull_request repositoryId: "repo-guid" sourceRefName: "refs/heads/feature-branch" targetRefName: "refs/heads/main" title: "My New Feature" description: "Details of the feature"'
具体的工具和参数信息可以参考仓库 README.md 文件中 "Available Tools" 章节。

验证安装

在仓库根目录下运行以下命令，可以启动 MCP Inspector 工具，用于验证服务器是否正常工作：

npm run inspector

该工具可以帮助你测试服务器的功能和连接性。

关键词