⭐ Azure DevOps MCP服务器
轻松为VS Code或VS Code Insider安装Azure DevOps MCP服务器：
 
这个TypeScript项目提供了一个 本地 用于Azure DevOps的MCP服务器，使您能够直接从代码编辑器执行各种Azure DevOps任务。
📄 目录
📺 概述
Azure DevOps MCP服务器为您的代理带来Azure DevOps上下文。尝试以下提示：
- “列出我的ADO项目”
- 列出“Contoso”的ADO构建
- 列出“Contoso”的ADO存储库
- 列出“Contoso”的测试计划
- 列出项目“Contoso”的团队
- 列出项目“Contoso”的迭代次数
- 列出项目“Contoso”的工作项
- 列出“Contoso”项目和“Contoso团队”当前迭代中的工作项
- 列出“Contoso”项目中的所有Wiki
- “创建一个包含系统设计内容的wiki页面'/Architecture/Overview'”
- “用新的入职说明更新维基页面“/入门”””
- “从文档wiki获取wiki页面'/neneneba API/身份验证'的内容”
🏆 期望
Azure DevOps MCP服务器由简洁、简单、专注和易于使用的工具构建而成，每个工具都是为特定场景设计的。我们有意避免使用试图做太多事情的复杂工具。目标是在REST API上提供一个薄的抽象层，使数据访问变得简单，并让语言模型处理复杂的推理。
⚙️ 支持的工具
看 工具集.md 一个全面的列表。
🔌 安装和入门
为了获得最佳体验，请使用Visual Studio Code和GitHub Copilot。看 开始文档 将我们的MCP服务器与Visual Studio 2022、Claude Code和Cursor等其他工具一起使用。
先决条件
- 安装 20+
- 在空文件夹中打开VS Code
安装
✨ 一键安装
 
安装后，选择GitHub Copilot Agent Mode并刷新工具列表。在中了解有关代理模式的更多信息 VS代码文档.
🧨 从公共源安装（推荐）
此安装方法对所有Visual Studio Code用户来说都是最简单的。
步骤
在您的项目中，添加 .vscode\mcp.json 包含以下内容的文件：
{
"inputs": [
{
"id": "ado_org",
"type": "promptString",
"description": "Azure DevOps organization name (e.g. 'contoso')"
}
],
"servers": {
"ado": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@azure-devops/mcp", "${input:ado_org}"]
}
}
}🔥 要了解最新功能，您可以使用我们的夜间版本。只需更新您的 mcp.json 要使用的配置 @azure-devops/mcp@next。以下是一个更新的示例：
{
"inputs": [
{
"id": "ado_org",
"type": "promptString",
"description": "Azure DevOps organization name (e.g. 'contoso')"
}
],
"servers": {
"ado": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@azure-devops/mcp@next", "${input:ado_org}"]
}
}
}保存文件，然后单击“开始”。
在聊天中，切换到 代理模式.
单击“选择工具”并选择可用工具。
打开GitHub Copilot Chat，尝试以下提示 List ADO projects。第一次执行ADO工具时，浏览器将打开提示，要求使用您的Microsoft帐户登录。请确保您使用的凭据与所选的Azure DevOps组织匹配。
💥 我们强烈建议创建一个.github\copilot-instructions.md在你的项目中。这将增强您使用带有GitHub Copilot Chat的Azure DevOps MCP服务器的体验。 首先，只需包括“This project uses Azure DevOps. Always check to see if the Azure DevOps MCP server has a tool relevant to the user's request“在你的副驾驶指令文件中。
看 开始文档 将我们的MCP服务器与Visual Studio 2022、Claude Code和Cursor等其他工具一起使用。
🛠️ 开发环境设定（Development Setup）
如果你正在开发或修改此MCP Server，需要使用本地编译的版本进行测试，请依照以下步骤设定：
1.编译项目
npm install
npm run build2.设定mcp.json（本地开发版）
在你的项目中建立 .vscode/mcp.json，使用 node 直接执行编译后的 dist/index.js：
{
"servers": {
"tmc-devops-mcp-dev": {
"type": "stdio",
"command": "node",
"args": [
"/path/to/tmc-devops-mcp/dist/index.js",
"你的organization名稱"
],
"env": {
"LOG_LEVEL": "debug"
}
}
}
}⚠️ 注意：请将/path/to/tmc-devops-mcp/替换为你实际的项目绝对路径，并将你的organization名稱替换为实际的Azure DevOps organization名称。
3.使用Watch模式开发
开发时可以开启TypeScript watch模式，自动重新编译：
npm run watch每次修改代码后，只需在VS Code中重新启动MCP Server即可测试新的变更。
4.使用MCP Inspector调试
项目内置MCP Inspector支持，可以用来检视工具定义和测试：
npm run inspect这会启动一个可视化界面，让你可以直接测试各个工具的输入输出。
🌏 使用域名
Azure DevOps暴露了很大的表面积。因此，我们的Azure DevOps MCP服务器包含许多工具。为了保持工具集的可管理性，避免混淆模型，并尊重客户端对加载工具的限制，请使用Domains仅加载您需要的区域。域是命名的相关工具组（例如：核心、工作、工作项、存储库、维基）。添加 -d 参数和域名到服务器参数中 mcp.json 列出要启用的域。
例如，使用 "-d", "core", "work", "work-items" 只加载与工作项相关的工具（见下面的示例）。
{
"inputs": [
{
"id": "ado_org",
"type": "promptString",
"description": "Azure DevOps organization name (e.g. 'contoso')"
}
],
"servers": {
"ado_with_filtered_domains": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@azure-devops/mcp", "${input:ado_org}", "-d", "core", "work", "work-items"]
}
}
}可用的域名有： core, work, work-items, search, test-plans, repositories, wiki, pipelines, advanced-security
我们建议您始终启用 core 工具，以便您可以获取项目级信息。
默认情况下，所有域都已加载
📝 故障排除
看 故障排除指南 有关常见问题和日志记录的帮助。
🎩 示例和最佳实践
在我们的 示例文档.
有关增强MCP服务器体验的最佳实践和提示，请参阅 如何指导.
🙋♀️ 常见问题
有关Azure DevOps MCP服务器常见问题的答案，请参阅 常见问题.
📌 贡献
我们欢迎捐款！在预览期间，请提交错误、增强或文档改进的问题。
查看我们的 贡献指南 用于：
- 🛠️ 开发设置
- ✨ 添加新工具
- 📝 代码风格和测试
- 🔄 拉取请求流程
⚠️ 请阅读 贡献指南 在创建pull请求之前。
🤝 行为准则
该项目遵循 微软开源行为准则. 如有疑问，请参阅 常见问题解答 或联系 open@microsoft.com.
📈 项目统计
🏆 名人堂
感谢所有让这个项目变得棒极了的贡献者！ ❤️
生成于 控制锁
许可证
根据 MIT许可证.
______________________________________________________________________
_商标：本项目可能包含微软或第三方的商标或徽标。使用Microsoft商标或徽标必须遵循 微软商标和品牌指南。第三方商标受其各自政策的约束。_