Azuredevops MCP

🚀 Azure DevOps MCP 服務器指南

本指南將幫助您瞭解如何使用 Azure DevOps MCP 服務器，該服務器基於 MCP（機器類協議）與 Azure DevOps 服務交互，可自動化和管理各類開發任務。

🚀 快速開始

配置項目

身份驗證設置

為連接到 Azure DevOps，需進行身份驗證，支持以下兩種方法：

1. 個人訪問令牌（PAT）：

az devops login --organization https://dev.azure.com/your-org --username your-username --password your-pat

2. OAuth2.0：

• 登錄 Azure DevOps。
• 生成新的訪問令牌。
• 使用生成的令牌進行身份驗證。

連接到 Azure DevOps 組織

在項目配置文件中指定目標組織：

export const config = {
  organization: 'your-org',
  project: 'your-project',
  // 其他配置...
};

✨ 主要特性

項目結構清晰

項目分為以下幾個主要部分：

• src/
  • Interfaces/：定義參數和響應的類型。
  • Services/：處理與 Azure DevOps API 的通信。
  • Tools/：提供 MCP 協議接口的功能實現。
  • index.ts：服務器啟動入口點。
  • config.ts：配置管理。

豐富的服務層

核心服務類

• WorkItemService：處理工作項操作，如創建、更新和查詢。
• GitService：管理代碼倉庫，包括分支、標籤和提交操作。
• BuildService：控制構建過程，監控構建狀態。
• ReleaseService：管理發佈管道，執行環境配置。

實用的工具層

工具實現

• GitTools：提供代碼倉庫操作接口，如 listRepositories、getBranches 等。
• BuildTools：封裝構建相關功能，如 queueBuild、getBuildStatus 等。

📦 安裝指南

本指南未提及具體安裝步驟，可參考配置項目部分進行身份驗證和連接組織等操作。

💻 使用示例

基礎用法

// src/Services/WorkItemService.ts
export class WorkItemService {
  private client: WorkItemHttpClient;

  constructor() {
    this.client = new WorkItemHttpClient();
  }

  public async getWorkItems(query: string): Promise<WorkItem[]> {
    return await this.client.queryWorkItems(query);
  }
}

📚 詳細文檔

配置管理

項目配置存儲在 config.ts 文件中：

export const config = {
  organizationUrl: 'https://dev.azure.com/your-org',
  projectId: 'your-project-id',
  authentication: {
    type: 'pat', // 可選：'oauth2'
    token: 'your-personal-access-token'
  }
};

身份驗證流程

1. 初始化身份驗證提供程序：

const authProvider = new AzureAuthProvider(config.authentication);

2. 獲取訪問令牌：

async function getAccessToken(): Promise<string> {
  return await authProvider.getAccessToken();
}

🔧 技術細節

本項目圍繞 Azure DevOps MCP 服務器展開，通過配置身份驗證連接到 Azure DevOps 服務。項目結構清晰，分為多個主要部分，服務層提供核心服務類處理不同業務操作，工具層封裝了實用工具。配置管理集中在 config.ts 文件，身份驗證流程明確。

📄 許可證

項目遵循 MIT 許可證，具體見 LICENSE 文件。

📦 故障排除

常見問題

1. 認證錯誤

• 確保個人訪問令牌有效且具有正確的權限。
• 檢查組織 URL 是否正確。

2. TypeScript 編譯錯誤

• 使用 npm run build:ignore-errors 跳過類型檢查。
• 檢查是否有缺失或錯誤的類型定義。

🌟 貢獻指南

歡迎貢獻！按照以下步驟：

1. Fork 倉庫
2. 創建功能分支：

git checkout -b feature/amazing-feature

3. 提交更改：

git add .
git commit -m "添加新功能"

4. 推送到 GitHub：

git push origin feature/amazing-feature

通過以上指南，您可以成功配置和使用 Azure DevOps MCP 服務器，實現開發流程的自動化管理。