Azure DevOps MCP Server

Azure DevOps MCP Server

Azure DevOps MCP Server 是一種模型上下文協議(MCP)的伺服器實現。它可以讓 AI 助手,如 Claude 或 Cursor AI,安全地通過標準化工具與 Azure DevOps 資源互動,透過自然語言和 AI 驅動的自動化,使 DevOps 工作流程更容易使用。

Author: Tiberriver256


查看協議

什麼是 Azure DevOps MCP Server?

Azure DevOps MCP Server 是 AI 模型和 Azure DevOps API 之間的橋樑。它允許大型語言模型與 Azure DevOps 專案、工作項、代碼庫、管道、合併請求等進行互動。它將這些能力作為標準化的 MCP 工具提供,支持安全驗證並靈活整合到各種 AI 平台中。

如何配置

  1. 安裝 Node.js(版本 16 以上)和 npm 或 yarn。
  2. 確保您可以訪問 Azure DevOps 組織並具備所需的身份驗證憑證(個人訪問令牌、Azure 身份或 Azure CLI)。
  3. 通過將 MCP 伺服器配置添加到設置文件來與您的 AI 主機(例如 Claude Desktop、Cursor AI)整合。示例配置:
    • 對於 Azure 身份(使用 az login):
      {
        "mcpServers": {
          "azureDevOps": {
            "command": "npx",
            "args": ["-y", "@tiberriver256/mcp-server-azure-devops"],
            "env": {
              "AZURE_DEVOPS_ORG_URL": "https://dev.azure.com/your-organization",
              "AZURE_DEVOPS_AUTH_METHOD": "azure-identity",
              "AZURE_DEVOPS_DEFAULT_PROJECT": "your-project-name"
            }
          }
        }
      }
      
    • 對於 PAT 身份驗證:
      {
        "mcpServers": {
          "azureDevOps": {
            "command": "npx",
            "args": ["-y", "@tiberriver256/mcp-server-azure-devops"],
            "env": {
              "AZURE_DEVOPS_ORG_URL": "https://dev.azure.com/your-organization",
              "AZURE_DEVOPS_AUTH_METHOD": "pat",
              "AZURE_DEVOPS_PAT": "<YOUR_PAT>",
              "AZURE_DEVOPS_DEFAULT_PROJECT": "your-project-name"
            }
          }
        }
      }
      
  4. 有關更多環境變數和進階身份驗證(服務主體、CLI),請參考官方文檔。

如何使用

  • 使用配置好的設置啟動 Azure DevOps MCP Server,通常通過您的 AI 助手主機(Claude Desktop、Cursor AI 等)進行。
  • 當伺服器運行後,AI 模型可以發現並調用可用的工具(功能),執行與 DevOps 相關的操作,例如列出專案、創建工作項、管理代碼庫和觸發管道。
  • 使用自然語言提示來指示您的 AI 助手;它將通過 MCP 進行通信,執行在 Azure DevOps 中所需的操作。
  • 所有操作都使用您選擇的身份驗證方法安全執行,並將結果返回給您的助手或工作流程。

主要功能

  • 標準化且可擴展的協議,用於將 Azure DevOps 與 AI 助手整合。
  • 支持多種身份驗證模式:個人訪問令牌、Azure 身份和 Azure CLI。
  • 按 DevOps 功能區域(專案、工作項、代碼庫、管道等)組織的模組化結構。
  • 提供豐富的 MCP 工具集,用於讀取、搜索、修改和自動化 DevOps 任務。
  • 安全訪問雲端和可選的本地資源,尊重用戶權限。
  • 與流行的 AI 主機和 IDE 容易配置和整合。

使用案例

  • 通過 AI 驅動的命令自動化 DevOps 工作流程和過程(例如,通過提示創建和更新工作項)。
  • 將 Azure DevOps 的資訊和操作整合到 LLM 驅動的聊天機器人或編碼助手中。
  • 使得快速代碼、工作項或文檔搜索成為可能,使用自然語言查詢。
  • 允許 AI 代理觸發構建、管理合併請求或監控管道運行。
  • 通過對話式界面提升工程團隊的生產力和 DevOps 可見性。

常見問題

Q1: 支持哪些身份驗證方法?
A: 此伺服器支持個人訪問令牌(PAT)、Azure 身份(DefaultAzureCredential)和 Azure CLI 作為身份驗證方法。每個方法都有其特定的設置步驟;請參考文檔以獲取詳細信息。

Q2: 我可以限制 AI 訪問特定的專案或代碼庫嗎?
A: 可以,訪問受憑證和權限的控制。AI 助手只能訪問該驗證帳戶可用的專案和資源。

Q3: 如果身份驗證失敗或伺服器無法連接到 Azure DevOps,我應該怎麼辦?
A: 常見的故障排除步驟包括檢查憑證有效性、檢查權限範圍、確認網絡連接以及查看日誌以查找配置錯誤。請參閱身份驗證指南以獲取更多故障排除提示。

Q4: 如何更新或擴展可用工具的集合?
A: 此伺服器是模組化的。新工具或功能模組可以通過更新代碼庫並註冊新工具處理程序來添加;請參閱貢獻指南以獲取幫助。

Q5: 在我的本地機器上運行此伺服器是安全的嗎?
A: 是的,只要您控制環境並保護您的身份驗證憑證。該伺服器默認不會將服務暴露於外部。