Azdo MCP

🚀 Azure DevOps MCP 服務器

Azure DevOps MCP 服務器提供與 Azure DevOps 的集成能力，藉助 MCP（模型上下文協議），它能讓 AI 助手與 Azure DevOps 的工作項、拉取請求以及 wiki 頁面進行交互，極大提升工作效率。

🚀 快速開始

本服務器可實現與 Azure DevOps 的集成，讓 AI 助手輕鬆與工作項、拉取請求和 wiki 頁面交互。以下為您詳細介紹使用步驟。

✨ 主要特性

• 🔧 工作項管理：支持創建、列出和獲取工作項。
• 📑 拉取請求操作：可進行創建、列出、獲取、評論和查看差異等操作。
• 📚 維基頁面管理：支持創建和編輯維基頁面。

📦 安裝指南

安裝準備

1. 安裝依賴：

npm install

2. 配置環境變量（創建一個 .env 文件）：

AZURE_DEVOPS_ORG_URL=https://dev.azure.com/your-org
AZURE_DEVOPS_PAT=你的個人訪問令牌
AZURE_DEVOPS_PROJECT=default-project
AZURE_DEVOPS_REPOSITORY=default-repo

3. 構建服務器：

npm run build

正式安裝

將服務器配置添加到您的 MCP 設置中：

對於 VSCode

• 在 macOS/Linux 上： 將以下內容添加到 ~/.vscode/cline_mcp_settings.json 或類似文件：

{
  "mcpServers": {
    "azure-devops": {
      "command": "node",
      "args": ["/path/to/azure-devops-mcp/build/index.js"],
      "devMode": false
    }
  }
}

• 在 Windows 上： 將以下內容添加到 C:\\Users\\<YourUsername>\\.vscode\\cline_mcp_settings.json：

{
  "mcpServers": {
    "azure-devops": {
      "command": "node",
      "args": ["C:\\path\\to\\azure-devops-mcp\\build\\index.js"],
      "devMode": false
    }
  }
}

💻 使用示例

工作項

基礎用法 - 創建工作項

POST /workitems
Content-Type: application/json

{
  "title": "新任務",
  "description": "這是一個新的 Azure DevOps 工作項。",
  "project": "default-project",
  "type": "task"
}

高級用法 - 獲取工作項

• 獲取所有工作項：

GET /workitems

• 獲取特定工作項：

GET /workitems/{id}

拉取請求

基礎用法 - 創建拉取請求

POST /pullrequests
Content-Type: application/json

{
  "sourceBranch": "refs/heads/main",
  "targetBranch": "refs/heads/master",
  "title": "新的功能提交"
}

高級用法 - 獲取拉取請求

• 獲取所有拉取請求：

GET /pullrequests

• 獲取特定拉取請求：

GET /pullrequests/{id}

維基

基礎用法 - 創建維基頁面

POST /wiki/defaultwiki/_/newfile
Content-Type: application/json

{
  "path": "/pages/home.md",
  "content": "## 歡迎來到我們的新維基！"
}

高級用法 - 更新維基頁面

PUT /wiki/defaultwiki/_/file/pages/home.md
Content-Type: application/json

{
  "content": "## 歡迎來到更新的維基！",
  "etag": "12345678-90AB-CDEF-1234-567890ABCDEF"
}

🔧 技術細節

在開發模式下運行，並使用環境變量：

npm run dev

⚠️ 重要提示

除非工具參數中明確指定了 project 和 repository，否則將使用從您的環境配置中指定的默認值。