适用于 Cline 的 Azure DevOps MCP 服务器
该模型上下文协议 (MCP) 服务器提供与 Azure DevOps 的集成,允许 Cline 与 Azure DevOps 服务进行交互。
先决条件
- Node.js(v20 LTS 或更高版本)
- npm(Node.js 附带)
- Cline 安装
- 具有访问令牌的 Azure DevOps 帐户
安装
通过 Smithery 安装
要通过Smithery自动为 Claude Desktop 安装 Azure DevOps 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
- 安装依赖项:
- 构建服务器:
注意:构建输出( build/
目录)不包含在版本控制中。您必须在克隆存储库后运行构建命令。
配置
1.获取 Azure DevOps 个人访问令牌(PAT)
- 转到 Azure DevOps 并登录
- 点击右上角的个人资料图片
- 选择“安全”
- 点击“新代币”
- 为您的令牌命名并选择所需的范围:
Code (read, write)
- 用于拉取请求操作Work Items (read, write)
- 用于工作项管理Build (read, execute)
- 用于管道操作Wiki (read, write)
- 用于 Wiki 操作Project and Team (read)
- 有关项目和董事会的信息
- 复制生成的token
2. 配置 Cline MCP 设置
将服务器配置添加到您的 Cline MCP 设置文件:
- 对于 VSCode 扩展:
%APPDATA%/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json
- 对于 Claude 桌面应用程序:
%LOCALAPPDATA%/Claude/claude_desktop_config.json
向mcpServers
对象添加以下配置:
{
"mcpServers": {
"azure-devops": {
"command": "node",
"args": ["/absolute/path/to/azure-devops-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": []
}
}
}
替换以下值:
/absolute/path/to/azure-devops-server
:克隆此存储库的绝对路径your-organization
:您的 Azure DevOps 组织名称your-project-name
:您的 Azure DevOps 项目名称your-personal-access-token
:您在步骤 1 中生成的 PAT
可用工具
工作项目
get_work_item
:通过 ID 获取工作项list_work_items
:使用 WIQL 查询工作项create_work_item
:创建一个新的工作项(Bug、任务、用户故事)update_work_item
:更新现有工作项
板
管道
list_pipelines
:列出项目中的所有管道trigger_pipeline
:执行管道
拉取请求
list_pull_requests
:列出拉取请求create_pull_request
:创建一个新的拉取请求update_pull_request
:更新拉取请求get_pull_request
:获取拉取请求详细信息
维基百科
get_wikis
:列出项目中的所有 wikiget_wiki_page
:获取 wiki 页面create_wiki
:创建一个新的wikiupdate_wiki_page
:创建或更新 wiki 页面
项目
list_projects
:列出 Azure DevOps 组织中的所有项目
确认
- 添加配置后重启Cline(或VSCode)
- Azure DevOps MCP 服务器现在应该列在 Cline 的功能中
- 您可以使用 MCP Inspector 验证安装:
故障排除
- 如果服务器未连接:
- 检查 MCP 设置中的路径是否正确
- 验证你的 Azure DevOps 凭据
- 检查 Cline 日志中是否有任何错误消息
- 如果出现身份验证错误:
- 确认您的 PAT 尚未过期
- 确保 PAT 具有所有必要的范围
- 仔细检查组织和项目名称
- 对于其他问题:
- 运行检查工具来验证服务器是否正常工作
- 检查服务器日志中是否有任何错误消息
发展
要修改或扩展服务器:
- 在
src
目录中进行更改 - 运行
npm run watch
进行开发 - 准备就绪后使用
npm run build
进行构建 - 使用检查器进行测试:
npm run inspector
执照
MIT 许可证 - 详情请参阅许可证