Azure Devops MCP Server

🚀 Azure DevOps MCP 服務器

Azure DevOps MCP 服務器讓你能夠通過自然語言更便捷地與 Azure DevOps 進行交互。它基於 TypeScript 構建，藉助 axios 調用 Azure DevOps REST API 來管理 Azure DevOps 工作項。

✨ 主要特性

此服務器提供了一系列工具，用於管理 Azure DevOps 資源：

• create_work_item：可在 Azure DevOps 中創建新的工作項，如用戶故事、Bug、任務等。
  • 必要參數：type（類型）、title（標題）。
  • 可選參數：projectName（項目名稱，默認為當前項目）、description（描述）、severity（嚴重性）、priority（優先級）、state（狀態）、assignee（分配給）、tags（標籤列表）。
• query_work_items：用於查詢 Azure DevOps 項目中的工作項。
  • 必要參數：projectName（項目名稱，默認為當前項目）、query（查詢條件，支持 Azure Query Language）。
  • 返回結果：匹配的工作項列表。
• update_work_item：可更新現有工作項的屬性。
  • 必要參數：id（工作項 ID）、fields（需要更新的字段及其值）。
• delete_work_item：用於刪除指定的工作項。
  • 必要參數：id（工作項 ID）。

📦 安裝指南

若要使用此 MCP 服務器，請按以下步驟進行安裝：

1. 克隆代碼庫：

   git clone https://github.com/yourusername/azure-devops-mcp-server.git
   cd azure-devops-mcp-server
   

2. 安裝依賴項：

   npm install
   

3. 構建服務器：

   npm run build
   

4. （可選）配置開發環境以自動重建：

   npm run watch
   

💻 使用示例

基礎用法

要在 Claude Desktop 中使用此 MCP 服務器，請按以下步驟進行配置：

Windows 系統

• 打開 %APPDATA%/Claude/claude_desktop_config.json 文件。
• 在 mcpServers 節點下添加以下內容：

  {
    "azure-devops-mcp-server": {
      "command": "C:\\Program Files\\nodejs\\node.exe",
      "args": ["C:\\Tools\\Claude\\MCP\\ azure-devops-mcp-server\\build\\index.js"],
      "env": {
        "AZURE_DEVOPS_ORG_URL": "YOUR_ORG_URL", // 示例：https://dev.azure.com/YourOrganizationName
        "AZURE_DEVOPS_PAT": "YOUR_PERSONAL_ACCESS_TOKEN"
      }
    }
  }
  

• 將 YOUR_ORG_URL 替換為您的 Azure DevOps 組織 URL，將 YOUR_PERSONAL_ACCESS_TOKEN 替換為您自己的個人訪問令牌。

MacOS 系統

• 打開 ~/Library/Application Support/Claude/claude_desktop_config.json 文件。
• 在 mcpServers 節點下添加以下內容：

  {
    "azure-devops-mcp-server": {
      "command": "/usr/local/bin/node",
      "args": ["C:\\Tools\\Claude\\MCP\\ azure-devops-mcp-server\\build\\index.js"],
      "env": {
        "AZURE_DEVOPS_ORG_URL": "YOUR_ORG_URL", // 示例：https://dev.azure.com/YourOrganizationName
        "AZURE_DEVOPS_PAT": "YOUR_PERSONAL_ACCESS_TOKEN"
      }
    }
  }
  

• 將 YOUR_ORG_URL 替換為您的 Azure DevOps 組織 URL，將 YOUR_PERSONAL_ACCESS_TOKEN 替換為您自己的個人訪問令牌。

📚 詳細文檔

調試說明

由於 MCP 服務器通過標準輸入輸出進行通信，調試可能具有一定挑戰性。我們建議使用 MCP 檢查器，這是一個作為包腳本提供的工具：

npm run inspector

檢查器將在瀏覽器中提供一個調試工具的 URL。

參考資料

• Azure DevOps REST API 參考文檔