MCP Server Azure Devops

🚀 Azure DevOps MCP 服務器

Azure DevOps MCP（模型上下文協議）服務器是一款用於與 Azure DevOps 服務進行交互的實用工具。它具備豐富多樣的功能，涵蓋用戶管理、項目管理、代碼存儲庫訪問、工作項操作、搜索功能、管道管理、Wiki 操作以及拉取請求管理等多個方面，能有效提升與 Azure DevOps 服務交互的效率和便捷性。

🚀 快速開始

先決條件

1. 安裝 Node.js 和 npm： 確保你已經安裝了 Node.js 和 npm。你可以從 Node.js 官方網站 下載並安裝。
2. 克隆倉庫：

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

3. 安裝依賴項：

npm install

4. 配置環境變量： 根據文檔中的要求，設置必要的環境變量（如 AZURE_DEVOPS_TOKEN 等）。
5. 運行服務器：

node index.js

✨ 主要特性

Azure DevOps MCP 服務器提供了豐富的功能，涵蓋用戶、組織、項目、存儲庫、工作項、搜索、管道、Wiki 和拉取請求等多個方面的管理操作。

🔧 技術細節

服務器結構

核心組件

• 用戶工具
  • get_me：獲取已認證用戶的詳細信息（ID、顯示名稱、電子郵件）
• 組織工具
  • list_organizations：列出所有可訪問的組織
• 項目工具
  • list_projects：在一個組織中列出所有項目
  • get_project：獲取特定項目的詳細信息
  • get_project_details：獲取項目的全面詳細信息，包括流程、工作項類型和團隊
• 存儲庫工具
  • list_repositories：列出項目中的所有存儲庫
  • get_repository：獲取特定存儲庫的詳細信息
  • get_repository_details：獲取存儲庫的詳細信息，包括統計信息和引用
  • get_file_content：獲取存儲庫中文件或目錄的內容
• 工作項工具
  • get_work_item：按 ID 獲取工作項
  • create_work_item：創建新的工作項
  • update_work_item：更新現有工作項
  • list_work_items：在項目中列出工作項
  • manage_work_item_link：添加、刪除或更新工作項之間的鏈接
• 搜索工具
  • search_code：在項目的存儲庫中搜索代碼
  • search_wiki：在項目中搜索 Wiki 內容
  • search_work_items：在 Azure DevOps 中的所有項目中搜索工作項
• 管道工具
  • list_pipelines：列出項目中的所有管道
  • get_pipeline：獲取特定管道的詳細信息
  • trigger_pipeline：觸發管道運行，並可自定義參數
• Wiki 工具
  • get_wikis：在項目中列出所有 Wiki
  • get_wiki_page：獲取特定 Wiki 頁面的內容（純文本格式）
• 拉取請求工具
  • create_pull_request：在存儲庫之間創建新的拉取請求
  • list_pull_requests：列出和篩選項目或存儲庫中的拉取請求
  • get_pull_request_comments：獲取特定拉取請求的評論及其討論線程
  • add_pull_request_comment：向拉取請求添加評論（回覆現有評論或創建新線程）

認證方式

實現細節

認證模塊位於項目的 src/auth 目錄中。支持多種認證方法，包括：

• 基於令牌的認證： 使用 Azure DevOps 個人訪問令牌進行認證。 配置文件示例：

{
  "auth": {
    "method": "token",
    "token": "your_azure_devops_token"
  }
}

• 基於 OAuth 的認證： 使用 OAuth 2.0 進行認證。 配置文件示例：

{
  "auth": {
    "method": "oauth",
    "clientId": "your_client_id",
    "clientSecret": "your_client_secret"
  }
}

環境變量

以下是一些常用的環境變量及其描述：

錯誤處理

常見錯誤及解決方法

1. 未認證錯誤： 確保你已經設置並使用了有效的 Azure DevOps 令牌或 OAuth 令牌。
2. 權限不足錯誤： 檢查你的令牌是否有足夠的權限來執行所需的操作。 如果需要更高的權限，請生成新的令牌並授予適當權限。
3. 網絡連接問題： 確保你有穩定的互聯網連接，並且沒有被防火牆或代理阻止訪問 Azure DevOps 服務。
4. 解析錯誤： 檢查 API 請求的 URL 是否正確，並確保返回的數據格式與預期一致。

故障排除

調試步驟

1. 檢查日誌輸出： 在運行服務器時，注意控制檯輸出的任何錯誤或警告信息。

node index.js --debug

2. 驗證配置文件： 確保 config.json 文件中的所有參數都正確無誤。
3. 重新安裝依賴項： 如果遇到意外問題，嘗試刪除 node_modules 目錄並重新安裝依賴項。

rm -rf node_modules && npm install

💻 使用示例

基礎用法

1. 創建一個新的工作項：

const mcp = require('mcp-server-azure-devops');
mcp.createWorkItem({
  title: '新功能需求',
  description: '開發新的用戶故事功能。'
}, (error, workItem) => {
  if (error) {
    console.error('創建工作項時出錯:', error);
  } else {
    console.log('工作項已創建，ID:', workItem.id);
  }
});

2. 搜索代碼：

mcp.searchCode('Feature:X', (error, results) => {
  if (error) {
    console.error('搜索代碼時出錯:', error);
  } else {
    console.log('找到的文件:', results.files);
  }
});

3. 觸發管道運行：

mcp.triggerPipeline('main', 'master', (error, pipelineRun) => {
  if (error) {
    console.error('觸發管道時出錯:', error);
  } else {
    console.log('管道已觸發，運行 ID:', pipelineRun.id);
  }
});

📄 許可證

本項目遵循 MIT License 協議。

問題反饋

提交問題

如果你在使用過程中遇到任何問題或需要幫助，請通過以下方式提交問題：

1. GitHub Issues： 訪問 項目倉庫，在 Issues 部分提交你的問題。
2. 郵件聯繫： 發送郵件至 support@yourdomain.com 聯繫開發團隊。

更新日誌

最新版本

• v1.0.0：初始版本，包含基本功能。
• v1.1.0：新增 OAuth 支持，修復若干已知錯誤。
• v1.2.0：改進性能和穩定性，支持更多 Azure DevOps 功能。