ADO-MCP服务器

Name: ADO-MCP服务器
Author: cakriwut

作者：cakriwut2 星标更新：2025-07-22

安装使用来源：spider==github.com

项目介绍

Azure DevOps MCP (ADO-MCP-Server) for Cline

此模型上下文协议（MCP）服务器提供了与Azure DevOps的集成，允许Cline和Roo Code与Azure DevOps服务进行交互。

项目仓库位于：https://github.com/cakriwut/ado-mcp-server

预备条件

Node.js（v20 LTS或更高版本）
npm（随Node.js一起提供）
Cline安装
具有访问令牌的Azure DevOps帐户

安装

通过Smithery安装

要通过Smithery自动安装Azure DevOps MCP服务器（ADO-MCP-Server）：

npx -y @smithery/cli install @cakriwut/ado-mcp-server --client claude

手动安装

克隆此仓库：

git clone https://github.com/cakriwut/ado-mcp-server.git
cd ado-mcp-server

安装依赖项：

npm install

构建服务器：

npm run build

注意：构建输出（build/目录）不在版本控制中。克隆仓库后必须运行构建命令。

配置

1. 获取Azure DevOps个人访问令牌（PAT）

登录到Azure DevOps
点击右上角的个人资料图片
选择“安全”
点击“新建令牌”
给你的令牌命名并选择所需的范围：
- 代码（读取、写入） - 用于拉取请求操作
- 工作项（读取、写入） - 用于工作项管理
- 构建（读取、执行） - 用于管道操作
- 维基（读取、写入） - 用于维基操作
- 项目和团队（读取） - 用于项目和看板信息
复制生成的令牌

2. 配置MCP设置

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

对于Roo Code（VSCode扩展）

配置文件位置：%APPDATA%/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json

对于Cline桌面应用

配置文件位置：%LOCALAPPDATA%/Claude/claude_desktop_config.json

在mcpServers对象中添加以下配置：

{
  "mcpServers": {
    "azure-devops-mcp-server": {
      "command": "node",
      "args": ["C:/absolute/path/to/ado-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": []
    }
  }
}

替换以下值：

C:/absolute/path/to/ado-mcp-server：您克隆此仓库的绝对路径（使用正斜杠）
your-organization：您的Azure DevOps组织名称
your-project-name：您的Azure DevOps项目名称
your-personal-access-token：步骤1中生成的PAT

重要提示（针对Windows用户）

在路径中使用正斜杠(/)，而不是反斜杠()
提供到build/index.js文件的完整绝对路径
更改配置后重启Roo Code或Cline

可用工具

工作项

get_work_item：根据ID获取工作项
list_work_items：使用WIQL查询工作项
create_work_item：创建新的工作项（Bug、任务、用户故事）
update_work_item：更新现有工作项
search_work_items：通过文本搜索查找工作项
add_work_item_comment：向工作项添加评论
get_work_item_comments：从工作项获取评论

看板

get_boards：获取项目中的可用看板

管道

list_pipelines：列出项目中的所有管道
trigger_pipeline：执行管道

拉取请求

list_pull_requests：列出拉取请求
create_pull_request：创建新的拉取请求
update_pull_request：更新拉取请求

维基

get_wikis：列出项目中的所有维基
list_wiki_pages：列出维基中的页面
get_wiki_page：根据路径获取维基页面
create_wiki：创建新的维基
update_wiki_page：创建或更新维基页面
create_wiki_page：创建新的维基页面
search_wiki_page：通过文本搜索维基中的页面

项目

list_projects：列出Azure DevOps组织中的所有项目

命令行界面（CLI）

ADO-MCP-Server包括一个命令行界面，允许您直接从终端与Azure DevOps进行交互。构建项目后，CLI作为azure-devops-cli可用。

环境设置

在使用CLI之前，请设置环境变量：

# PowerShell
$env:AZURE_DEVOPS_ORG = "your-organization"
$env:AZURE_DEVOPS_PROJECT = "your-project-name"
$env:AZURE_DEVOPS_PAT = "your-personal-access-token"

常见CLI命令

工作项

# 根据ID获取工作项
node .\build\cli\index.js work-item get -i 42

# 查找工作项
node .\build\cli\index.js work-item search -s "bug"

# 创建新任务
node .\build\cli\index.js work-item create -t "Task" -d '[{"op":"add","path":"/fields/System.Title","value":"New Task"}]'

# 向工作项添加评论
node .\build\cli\index.js work-item add-comment -i  42 -t "这是通过CLI添加的评论"

# 从工作项获取评论
node .\build\cli\index.js work-item get-comments -i 42

维基

# 列出项目中的所有维基
node .\build\cli\index.js wiki list

# 获取维基页面
node .\build\cli\index.js wiki page -w <wikiIdentifier> -p "/path/to/page" --include-content

# 搜索维基页面
node .\build\cli\index.js wiki search -w <wikiIdentifier> -s "搜索词"

更多详细的CLI使用示例，请参阅docs/wiki-cli-usage.md和docs/command-list.md。

验证

添加配置后重启Cline（或VSCode）
Azure DevOps MCP服务器现在应该列在Cline的能力中
您可以使用MCP检查器验证安装：

npm run inspector

故障排除

如果服务器无法连接：
- 检查您的MCP设置中的路径是否正确
- 验证您的Azure DevOps凭据
- 检查Cline日志中的错误消息
如果您遇到身份验证错误：
- 验证您的PAT是否未过期
- 确保PAT具有所有必要的范围
- 再次检查组织和项目名称
对于其他问题：
- 运行检查器工具以验证服务器是否正常工作
- 检查服务器日志中的错误消息

开发

要修改或扩展服务器：

在src目录中进行更改
运行npm run watch进行开发
准备就绪时使用npm run build构建
使用检查器测试：npm run inspector

测试

该项目包括所有MCP服务器命令的测试脚本。这些测试有助于验证服务器能否正确地与Azure DevOps通信。

测试预备条件

确保根目录下有一个有效的.env文件，其中包含以下变量：

AZURE_DEVOPS_ORG=your-organization
AZURE_DEVOPS_PROJECT=your-project
AZURE_DEVOPS_PAT=your-personal-access-token

安装依赖项：
```
npm install
```

运行测试

快速测试

对于快速测试您的Azure DevOps连接：

npm run test:quick

这将运行一个简单的JavaScript测试，仅测试list_projects命令。

对于更全面的所有MCP服务器命令测试：

npm run test:simple

这将运行一个简单的JavaScript测试，测试所有主要命令在一个文件中。

TypeScript测试

要运行所有TypeScript测试：

npm test

要运行特定命令类别的测试：

npm run test:work-item     # 测试工作项工具
npm run test:board         # 测试看板工具
npm run test:wiki          # 测试维基工具
npm run test:project       # 测试项目工具
npm run test:pipeline      # 测试管道工具
npm run test:pull-request  # 测试拉取请求工具

有关测试的更多信息，请参阅tests/README.md文件。

许可证

MIT许可证 - 详情请参阅LICENSE