Azure DevOps Server MCP
leidottw/ado-server-mcp
Integração completa com Azure DevOps Server para automação e gerenciamento
Ver no GitHubMCP Server para integração com Azure DevOps Server on-premise, fornecendo acesso programático a work items, pull requests, pipelines, iterations e gerenciamento de projetos. Implementado em TypeScript com Bun, permite automatizar fluxos de trabalho e consultas complexas via WIQL.
Instalação
npx convez-ai leidottw/ado-server-mcp1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Automatizar criação e atualização de work items em pipelines CI/CD
- Gerenciar pull requests, revisões e discussões programaticamente
- Consultar e executar pipelines, acessar logs de build
- Estruturar iterations e áreas de projeto, atribuir a times
- Sincronizar dados de ADO com outras ferramentas via Claude
Veredito

Server robusto e bem documentado para ambientes on-premise do Azure DevOps. Cobertura abrangente de APIs (work items, PRs, pipelines, projetos) o torna adequado para automação corporativa, mas exige conhecimento prévio de ADO e configuração correta de tokens PAT.
README
A tradução para o português deste README ainda está na fila.
Azure DevOps Server MCP
本專案是為 Azure DevOps Server (On-Premise) 建置的自訂 MCP (Model Context Protocol) Server,使用 Bun 作為執行環境與打包工具。
功能
工作項管理
get_work_item- 取得單一工作項目詳細資料create_work_item- 建立新的工作項目update_work_item- 更新工作項目欄位或工作流程狀態query_work_items- 使用 WIQL 查詢工作項目list_work_item_types- 列出專案中可用的工作項目類型add_work_item_comment- 在工作項目上新增評論get_work_item_comments- 取得工作項目的評論清單add_work_item_tags- 安全附加 Tag 至工作項目(merge 現有 Tag,不覆蓋)remove_work_item_tags- 從工作項目精確移除指定 Tag,保留其餘 Tag
Iteration 管理
create_iteration- 在指定父路徑下建立 Iteration 節點,支援設定起訖日期update_iteration- 更新既有 Iteration 節點的名稱或起訖日期list_iterations- 查詢專案下的 Iteration / Area 樹狀結構assign_team_iteration- 將 Iteration 節點指派給指定 Teamlist_team_iterations- 查詢 Team 已指派的 Iteration 清單(支援 timeframe 篩選)
拉取請求管理
get_repositories- 列出指定專案內的 Git 儲存庫get_pull_requests- 取得指定專案下的 Git 拉取請求get_pull_request_details- 取得單一拉取請求詳細資訊(含所有討論串)create_pull_request- 建立新的拉取請求create_pull_request_thread- 在拉取請求上建立新討論串(支援錨定至特定程式碼行)create_pull_request_thread_comment- 在拉取請求的現有討論串中新增留言get_pull_request_threads- 取得拉取請求的所有討論串get_pull_request_changes- 取得拉取請求的檔案變更清單get_pull_request_statuses- 取得拉取請求的 CI/build 狀態清單update_pull_request- 更新拉取請求(標題、說明、狀態、草稿模式)update_pull_request_reviewer- 設定或更新拉取請求的審查者投票(核准、拒絕等)update_pull_request_thread- 更新拉取請求討論串的狀態(例如標記為已解決)
Pipeline 管理
list_pipelines- 列出專案中的 CI/CD Pipeline 定義(Build Definitions)list_pipeline_runs- 列出 Pipeline 的執行歷程(Builds)get_pipeline_run- 取得單一 Pipeline 執行(Build)的詳細資訊與結果queue_pipeline- 觸發 Pipeline 執行(Queue a Build)get_pipeline_definition- 取得單一 Pipeline 定義的詳細資訊,包含 repository、變數與觸發設定get_pipeline_definition_yaml- 取得 Pipeline 定義的完整 YAML 內容get_build_logs- 取得 Build 的 log 清單或特定 log 的內容
專案管理
list_projects- 列出 Collection 中可存取的專案清單get_project- 取得單一專案的詳細資訊get_project_teams- 取得指定專案底下的團隊列表get_team- 取得特定團隊的詳細資訊get_team_members- 取得特定團隊的成員列表
需求條件
- Node.js 18+ 或 Bun
- Azure DevOps Server (On-Premise) 實例
- 有效的 Personal Access Token
快速開始
參考下方設定說明,將 MCP Server 加入你使用的 AI 工具。
GitHub Copilot (VS Code) MCP 設定
- 在 VS Code 中開啟命令面板 (
Cmd/Ctrl + Shift + P) - 執行
MCP: Open User Configuration - 將以下配置貼入:
{
"inputs": [
{
"id": "azureDevOpsUrl",
"type": "promptString",
"description": "Azure DevOps Server URL,例如 https://my-server/DefaultCollection",
"default": ""
},
{
"id": "azureDevOpsToken",
"type": "promptString",
"description": "Azure DevOps Personal Access Token",
"default": ""
}
],
"servers": {
"azure-devops-server": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@cb/ado-server-mcp"],
"env": {
"AZURE_DEVOPS_URL": "${input:azureDevOpsUrl}",
"AZURE_DEVOPS_TOKEN": "${input:azureDevOpsToken}",
"NODE_TLS_REJECT_UNAUTHORIZED": "0"
}
}
}
}
Claude Code MCP 設定
在 ~/.claude.json 的根層加入 mcpServers,設定後對所有專案生效:
{
"mcpServers": {
"azure-devops-server": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@cb/ado-server-mcp"],
"env": {
"AZURE_DEVOPS_URL": "https://my-server/DefaultCollection",
"AZURE_DEVOPS_TOKEN": "your-pat-token",
"NODE_TLS_REJECT_UNAUTHORIZED": "0"
}
}
}
}
或直接使用 CLI 新增(效果相同):
claude mcp add --scope user azure-devops-server \
-e AZURE_DEVOPS_URL=https://my-server/DefaultCollection \
-e AZURE_DEVOPS_TOKEN=your-pat-token \
-e NODE_TLS_REJECT_UNAUTHORIZED=0 \
-- npx -y @cb/ado-server-mcp
開發
設置開發環境
bun install
環境變數
在開發時,則需要建立 .env 檔案,置入以下變數:
| 變數名 | 說明 | 示例 |
|---|---|---|
AZURE_DEVOPS_URL | Azure DevOps Server 的完整 URL,包含 collection 路徑 | http://my-local-server:8080/tfs/DefaultCollection |
AZURE_DEVOPS_TOKEN | Personal Access Token,用於 API 認證 | [your-pat-token] |
NODE_TLS_REJECT_UNAUTHORIZED | 若使用自簽章 HTTPS,設定爲 0 以允許繞過驗證 | 0 或 1 (預設) |
本機 MCP 設定
開發時可將 AI 工具指向本機 bun start,環境變數由 .env 自動載入,無需額外設定。
GitHub Copilot (VS Code):加入 MCP User Configuration:
{
"servers": {
"azure-devops-server-dev": {
"type": "stdio",
"command": "bun",
"args": ["start"]
}
}
}
Claude Code:
claude mcp add azure-devops-server-dev -- bun start
常用命令
| 命令 | 說明 |
|---|---|
bun start | 直接啟動 MCP server (開發用) |
bun run build | 編譯 TypeScript 為 Node.js 可執行的 JavaScript,輸出到 ./dist |
發佈前注意:發佈到 registry 前必須先執行
bun run build,確保dist/為最新版本。
專案結構
src/
├── index.ts # MCP server 入口點
├── client.ts # Azure DevOps API 客戶端
├── types/
│ └── azureDevOps.ts # 類型定義
└── tools/
├── projects.ts # 專案相關工具
├── pullRequests.ts # 拉取請求相關工具
├── workItems.ts # 工作項相關工具
└── iterations.ts # Iteration 管理工具
License
MIT