[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-77782":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":9,"totalLinesOfCode":9,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":9,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":21,"rankGlobal":9,"rankLanguage":9,"license":9,"archived":22,"fork":22,"defaultBranch":23,"hasWiki":22,"hasPages":22,"topics":9,"createdAt":9,"pushedAt":9,"updatedAt":24,"readmeContent":25,"aiSummary":26,"trendingCount":16,"starSnapshotCount":16,"syncStatus":27,"lastSyncTime":28,"discoverSource":29},77782,"azure-devops-mcp","microsoft\u002Fazure-devops-mcp","microsoft","The MCP server for Azure DevOps, bringing the power of Azure DevOps directly to your agents.",null,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fazure-devops-mcp","TypeScript",1803,579,23,5,0,40,58,96,120,102.89,false,"main","2026-06-12 04:01:22","# ⭐ Azure DevOps MCP Server\n\n> [!IMPORTANT]\n> The Azure DevOps Remote MCP Server is now available in public preview for all organizations. We recommend migrating to the [Remote MCP Server](https:\u002F\u002Flearn.microsoft.com\u002Fen-us\u002Fazure\u002Fdevops\u002Fmcp-server\u002Fremote-mcp-server) going forward.\n>\n> [Learn more](#-remote-mcp-server-recommended)\n\nThis project provides Azure DevOps MCP tooling for AI agents, with a **remote-first** onboarding experience and a local server option when you need it.\n\n## 📄 Table of Contents\n\n1. [📺 Overview](#-overview)\n2. [🏆 Expectations](#-expectations)\n3. [🚀 Remote MCP Server (Recommended)](#-remote-mcp-server-recommended)\n4. [⚙️ Supported Tools](#️-supported-tools)\n5. [🔌 Local MCP Server Installation (Optional)](#-local-mcp-server-installation-optional)\n6. [🌏 Using Domains (local)](#-using-domains-local)\n7. [🐥 Project and Team Defaults (local)](#-project-and-team-defaults-local)\n8. [📝 Troubleshooting](#-troubleshooting)\n9. [🎩 Examples & Best Practices](#-examples--best-practices)\n10. [🙋‍♀️ Frequently Asked Questions](#️-frequently-asked-questions)\n11. [📌 Contributing](#-contributing)\n\n## 📺 Overview\n\nThe Azure DevOps MCP Server brings Azure DevOps context to your agents. Try prompts like:\n\n- \"List my ADO projects\"\n- \"List ADO Builds for 'Contoso'\"\n- \"List ADO Repos for 'Contoso'\"\n- \"List test plans for 'Contoso'\"\n- \"List teams for project 'Contoso'\"\n- \"List iterations for project 'Contoso'\"\n- \"List my work items for project 'Contoso'\"\n- \"List work items in current iteration for 'Contoso' project and 'Contoso Team'\"\n- \"List all wikis in the 'Contoso' project\"\n- \"Create a wiki page '\u002FArchitecture\u002FOverview' with content about system design\"\n- \"Update the wiki page '\u002FGetting Started' with new onboarding instructions\"\n- \"Get the content of the wiki page '\u002FAPI\u002FAuthentication' from the Documentation wiki\"\n\n## 🏆 Expectations\n\nThe Azure DevOps MCP Server is built around tools that are concise, simple, focused, and easy to use, with each one designed for a specific scenario. We intentionally avoid creating complex tools that try to do too much. The goal is to provide a thin abstraction layer over the REST APIs that makes data access straightforward while allowing the language model to handle the more complex reasoning.\n\n## 🚀 Remote MCP Server (Recommended)\n\nThe Azure DevOps **Remote MCP Server** is now available in [public preview](https:\u002F\u002Fdevblogs.microsoft.com\u002Fdevops\u002Fazure-devops-remote-mcp-server-public-preview).\n\nOver time, the Remote MCP Server will replace this local MCP Server. We will continue to support the local server for now, but future investments will primarily focus on the remote experience.\n\nWe encourage all users of the local MCP Server to begin migrating to the Remote MCP Server.\n\nIf you encounter issues with tools, need support, or have a feature request, you can report an issue using the [Remote MCP Server issue template](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fazure-devops-mcp\u002Fissues\u002Fnew?template=remote-mcp-server-issue.md). During the preview period, we will track Remote MCP Server issues through this repository.\n\n> [!WARNING]\n> Internal Microsoft users of the Remote MCP Server should **not** create issues in this repository. Please use the dedicated Teams channel instead.\n\nFor complete instructions, see the [Remote MCP Server onboarding documentation](https:\u002F\u002Flearn.microsoft.com\u002Fen-us\u002Fazure\u002Fdevops\u002Fmcp-server\u002Fremote-mcp-server?view=azure-devops).\n\n### Quick start with `.vscode\u002Fmcp.json`\n\nUse this configuration to connect directly to the Azure DevOps-hosted endpoint using streamable HTTP transport:\n\n```json\n{\n  \"servers\": {\n    \"ado-remote-mcp\": {\n      \"url\": \"https:\u002F\u002Fmcp.dev.azure.com\u002F{organization}\",\n      \"type\": \"http\"\n    }\n  },\n  \"inputs\": []\n}\n```\n\nSee [documentation](https:\u002F\u002Flearn.microsoft.com\u002Fen-us\u002Fazure\u002Fdevops\u002Fmcp-server\u002Fremote-mcp-server?view=azure-devops#mcpjson-configuration) for additional configuration options.\n\nAfter saving `.vscode\u002Fmcp.json`, start the server from the MCP view in VS Code, then run a prompt like `List ADO projects`.\n\n## ⚙️ Supported Tools\n\nSee the [Available Tools](https:\u002F\u002Flearn.microsoft.com\u002Fen-us\u002Fazure\u002Fdevops\u002Fmcp-server\u002Fremote-mcp-server?view=azure-devops#available-tools) documentation for the complete list of available remote tools.\n\nFor a comprehensive list of local tools, see [TOOLSET.md](.\u002Fdocs\u002FTOOLSET.md).\n\n## 🔌 Local MCP Server Installation (Optional)\n\n> [!IMPORTANT]\n> Start with the Remote MCP Server first. Use the local MCP Server only if your scenario specifically requires a local `stdio` setup.\n\nUse this section if you specifically need the local `stdio` server experience. For most users, start with the [Remote MCP Server](#-remote-mcp-server-recommended) section above.\n\nFor the best experience, use Visual Studio Code and GitHub Copilot. See the [getting started documentation](.\u002Fdocs\u002FGETTINGSTARTED.md) to use our MCP Server with other tools such as Visual Studio 2022, Claude Code, Cursor, Opencode, and Kilocode.\n\n### Prerequisites\n\n1. Install [VS Code](https:\u002F\u002Fcode.visualstudio.com\u002Fdownload) or [VS Code Insiders](https:\u002F\u002Fcode.visualstudio.com\u002Finsiders)\n2. Install [Node.js](https:\u002F\u002Fnodejs.org\u002Fen\u002Fdownload) 20+\n3. Open VS Code in an empty folder\n\n### Installation\n\n#### 🧨 Install from Public Feed\n\nThis installation method is the easiest for all users of Visual Studio Code.\n\n🎥 [Watch this quick start video to get up and running in under two minutes!](https:\u002F\u002Fyoutu.be\u002FEUmFM6qXoYk)\n\n##### Steps\n\nIn your project, add a `.vscode\\mcp.json` file with the following content:\n\n```json\n{\n  \"inputs\": [\n    {\n      \"id\": \"ado_org\",\n      \"type\": \"promptString\",\n      \"description\": \"Azure DevOps organization name  (e.g. 'contoso')\"\n    }\n  ],\n  \"servers\": {\n    \"ado\": {\n      \"type\": \"stdio\",\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@azure-devops\u002Fmcp\", \"${input:ado_org}\"]\n    }\n  }\n}\n```\n\n🔥 To stay up to date with the latest features, you can use our nightly builds. Simply update your `mcp.json` configuration to use `@azure-devops\u002Fmcp@next`. Here is an updated example:\n\n```json\n{\n  \"inputs\": [\n    {\n      \"id\": \"ado_org\",\n      \"type\": \"promptString\",\n      \"description\": \"Azure DevOps organization name  (e.g. 'contoso')\"\n    }\n  ],\n  \"servers\": {\n    \"ado\": {\n      \"type\": \"stdio\",\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@azure-devops\u002Fmcp@next\", \"${input:ado_org}\"]\n    }\n  }\n}\n```\n\nSave the file, then click 'Start'.\n\n![start mcp server](.\u002Fdocs\u002Fmedia\u002Fstart-mcp-server.gif)\n\nIn chat, switch to [Agent Mode](https:\u002F\u002Fcode.visualstudio.com\u002Fblogs\u002F2025\u002F02\u002F24\u002Fintroducing-copilot-agent-mode).\n\nClick \"Select Tools\" and choose the available tools.\n\n![configure mcp server tools](.\u002Fdocs\u002Fmedia\u002Fconfigure-mcp-server-tools.gif)\n\nOpen GitHub Copilot Chat and try a prompt like `List ADO projects`. The first time an ADO tool is executed browser will open prompting to login with your Microsoft account. Please ensure you are using credentials matching selected Azure DevOps organization.\n\n> 💥 We strongly recommend creating a `.github\\copilot-instructions.md` in your project. This will enhance your experience using the Azure DevOps MCP Server with GitHub Copilot Chat.\n> To start, just include \"`This project uses Azure DevOps. Always check to see if the Azure DevOps MCP server has a tool relevant to the user's request`\" in your copilot instructions file.\n\nSee the [getting started documentation](.\u002Fdocs\u002FGETTINGSTARTED.md) to use our MCP Server with other tools such as Visual Studio 2022, Claude Code, and Cursor.\n\n## 🌏 Using Domains (local)\n\nAzure DevOps exposes a large surface area. As a result, our Azure DevOps MCP Server includes many tools. To keep the toolset manageable, avoid confusing the model, and respect client limits on loaded tools, use Domains to load only the areas you need. Domains are named groups of related tools (for example: core, work, work-items, repositories, wiki). Add the `-d` argument and the domain names to the server args in your `mcp.json` to list the domains to enable.\n\nFor example, use `\"-d\", \"core\", \"work\", \"work-items\"` to load only Work Item related tools (see the example below).\n\n```json\n{\n  \"inputs\": [\n    {\n      \"id\": \"ado_org\",\n      \"type\": \"promptString\",\n      \"description\": \"Azure DevOps organization name  (e.g. 'contoso')\"\n    }\n  ],\n  \"servers\": {\n    \"ado_with_filtered_domains\": {\n      \"type\": \"stdio\",\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@azure-devops\u002Fmcp\", \"${input:ado_org}\", \"-d\", \"core\", \"work\", \"work-items\"]\n    }\n  }\n}\n```\n\nDomains that are available are: `core`, `work`, `work-items`, `search`, `test-plans`, `repositories`, `wiki`, `pipelines`, `advanced-security`\n\nWe recommend that you always enable `core` tools so that you can fetch project level information.\n\n> By default all domains are loaded\n\n## 🐥 Project and Team Defaults (local)\n\nYou can also configure default Azure DevOps project and team values from `.vscode\u002Fmcp.json` using `project` and `team`, so tools can skip selection prompts.\n\n### Example `.vscode\u002Fmcp.json`\n\n```json\n{\n  \"servers\": {\n    \"ado\": {\n      \"type\": \"stdio\",\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@azure-devops\u002Fmcp\", \"myorg\", \"--authentication\", \"azcli\"],\n      \"env\": {\n        \"ado_mcp_project\": \"Contoso\",\n        \"ado_mcp_team\": \"Fabrikam Team\"\n      }\n    }\n  }\n}\n```\n\n## 📝 Troubleshooting\n\nSee the [Troubleshooting guide](.\u002Fdocs\u002FTROUBLESHOOTING.md) for help with common issues and logging.\n\n## 🎩 Examples & Best Practices\n\nExplore example prompts in our [Examples documentation](.\u002Fdocs\u002FEXAMPLES.md).\n\nFor best practices and tips to enhance your experience with the MCP Server, refer to the [How-To guide](.\u002Fdocs\u002FHOWTO.md).\n\n## 🙋‍♀️ Frequently Asked Questions\n\nFor answers to common questions about the Azure DevOps MCP Server, see the [Frequently Asked Questions](.\u002Fdocs\u002FFAQ.md).\n\n## 📌 Contributing\n\nWe welcome contributions! During preview, please file issues for bugs, enhancements, or documentation improvements.\n\nSee our [Contributions Guide](.\u002FCONTRIBUTING.md) for:\n\n- 🛠️ Development setup\n- ✨ Adding new tools\n- 📝 Code style & testing\n- 🔄 Pull request process\n\n> ⚠️ Please read the [Contributions Guide](.\u002FCONTRIBUTING.md) before creating a pull request.\n\n## 🤝 Code of Conduct\n\nThis project follows the [Microsoft Open Source Code of Conduct](https:\u002F\u002Fopensource.microsoft.com\u002Fcodeofconduct\u002F).\nFor questions, see the [FAQ](https:\u002F\u002Fopensource.microsoft.com\u002Fcodeofconduct\u002Ffaq\u002F) or contact [open@microsoft.com](mailto:open@microsoft.com).\n\n## 📈 Project Stats\n\n[![Star History Chart](https:\u002F\u002Fapi.star-history.com\u002Fsvg?repos=microsoft\u002Fazure-devops-mcp&type=Date)](https:\u002F\u002Fstar-history.com\u002F#microsoft\u002Fazure-devops-mcp)\n\n## 🏆 Hall of Fame\n\nThanks to all contributors who make this project awesome! ❤️\n\n[![Contributors](https:\u002F\u002Fcontrib.rocks\u002Fimage?repo=microsoft\u002Fazure-devops-mcp)](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fazure-devops-mcp\u002Fgraphs\u002Fcontributors)\n\n> Generated with [contrib.rocks](https:\u002F\u002Fcontrib.rocks)\n\n## License\n\nLicensed under the [MIT License](.\u002FLICENSE.md).\n\n---\n\n_Trademarks: This project may include trademarks or logos for Microsoft or third parties. Use of Microsoft trademarks or logos must follow [Microsoft’s Trademark & Brand Guidelines](https:\u002F\u002Fwww.microsoft.com\u002Fen-us\u002Flegal\u002Fintellectualproperty\u002Ftrademarks\u002Fusage\u002Fgeneral). Third-party trademarks are subject to their respective policies._\n\n\u003C!-- version: 2023-04-07 [Do not delete this line, it is used for analytics that drive template improvements] -->\n","Azure DevOps MCP 服务器项目旨在将 Azure DevOps 的功能直接带给用户的代理，通过提供一个远程优先的接入体验以及可选的本地服务器设置，使得用户能够更加灵活地管理和访问其DevOps资源。该项目采用TypeScript开发，核心功能包括支持多种Azure DevOps命令如列出项目、构建、代码仓库等，并且设计上强调简洁性与易用性，避免了工具复杂度。特别推荐使用其远程MCP服务器版本，适合需要提高团队协作效率、简化DevOps流程管理的企业或个人开发者使用。随着远程版本进入公共预览阶段，官方建议现有用户迁移至此新平台以获得更好的服务和支持。",2,"2026-06-11 03:56:00","trending"]