azure-devops-mcp-server MCP Server

透過自然語言更方便地與 Azure DevOps 互動。

This is a TypeScript-based MCP server designed to interact with Azure DevOps Work Items using the Azure DevOps REST API via axios.

Features

Tools

This server provides the following tools to manage Azure DevOps resources:

• create_work_item: 在 Azure DevOps 中建立新的 Work Item (例如 User Story, Bug, Task)。
  • 必要參數：type (類型), title (標題)。
  • 可選參數：description (描述), areaPath (區域路徑), iterationPath (迭代路徑), assignedTo (指派對象), tags (標籤)。
• get_work_item_details: 根據 ID 取得 Azure DevOps Work Item 的詳細資訊。
  • 必要參數：id (Work Item ID)。
• update_work_item: 更新現有 Azure DevOps Work Item 的欄位 (例如狀態、指派對象)。
  • 必要參數：id (Work Item ID), updates (包含要更新欄位和值的物件)。
  • 可選參數：comment (更新評論)。
• search_work_items: 搜尋 Azure DevOps Work Items。可依專案、類型、標題或 ID 進行篩選。
  • 可選參數：query (搜尋關鍵字), projectName (專案名稱), workItemType (工作項目類型)。
• list_projects: 列出 Azure DevOps 組織中的所有專案。
• get_project_details: 根據專案 ID 或名稱取得 Azure DevOps 專案的詳細資訊。
  • 必要參數：projectIdOrName (專案 ID 或名稱)。

Development

Install dependencies:

npm install

Build the server:

npm run build

For development with auto-rebuild:

npm run watch

Installation

To use with Claude Desktop, add the server config:

On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json On Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "azure-devops-mcp-server": {
      "command": "C:\\Program Files\\nodejs\\node.exe", // Or your Node.js path
      "args": [
        "C:\\Tools\\Cline\\MCP\\azure-devops-mcp-server\\build\\index.js" // Adjust path if needed
      ],
      "env": {
        "AZURE_DEVOPS_ORG_URL": "YOUR_ORG_URL", // e.g., https://dev.azure.com/YourOrganizationName
        "AZURE_DEVOPS_PAT": "YOUR_PERSONAL_ACCESS_TOKEN"
      }
    }
  }
}

重要： 您需要將 YOUR_ORG_URL 替換為您的 Azure DevOps 組織 URL，並將 YOUR_PERSONAL_ACCESS_TOKEN 替換為具有讀寫 Work Item 權限的有效 Personal Access Token (PAT)。

Debugging

Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector, which is available as a package script:

npm run inspector

The Inspector will provide a URL to access debugging tools in your browser.