使用说明
⭐ Azure DevOps MCP服务器
[！重要] Azure DevOps远程MCP服务器现在可供所有组织公开预览。我们建议迁移到 远程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上提供一个薄的抽象层，使数据访问变得简单，并让语言模型处理复杂的推理。
🚀 远程MCP服务器
Azure DevOps 远程MCP服务器 现在可以在 公开预览.
随着时间的推移，远程MCP服务器将取代此本地MCP服务器。目前，我们将继续支持本地服务器，但未来的投资将主要集中在远程体验上。
我们鼓励本地MCP服务器的所有用户开始迁移到远程MCP服务器。
如果您遇到工具问题、需要支持或有功能请求，您可以使用 远程MCP服务器问题模板。在预览期间，我们将通过此存储库跟踪远程MCP服务器问题。
[！警告] 远程MCP服务器的内部Microsoft用户应 不 在此存储库中创建问题。请使用专用的团队频道。
有关如何开始使用远程MCP服务器的说明，请参阅 入职文件.
⚙️ 支持的工具
看 工具集.md 一个全面的列表。
🔌 安装和入门
为了获得最佳体验，请使用Visual Studio Code和GitHub Copilot。请参阅 开始文档 将我们的MCP服务器与Visual Studio 2022、Claude Code、Cursor、Opencode和Kilocode等其他工具一起使用。
先决条件
安装
✨ 一键安装
安装后，选择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等其他工具一起使用。
🌏 使用域名
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商标或徽标必须遵循 微软商标和品牌指南。第三方商标受其各自政策的约束。
