Ado MCP

🚀 Azure DevOps 多租戶控制平面（MCP）

Azure DevOps 多租戶控制平面（MCP）為 Azure DevOps 提供了強大的管理和控制能力，通過直觀的架構設計和豐富的功能組件，幫助用戶高效管理組織、項目、倉庫等資源。

🚀 快速開始

環境變量配置

• ADO_ORGANIZATION: Azure DevOps 組織名稱（必填）
• ADO_PROJECT: 默認項目名稱（可選）
• ADO_PAT: 個人訪問令牌用於身份驗證（必填）
• ADO_API_URL: API 基 URL（可選，默認為 https://dev.azure.com）
• ADO_API_VERSION: API 版本（可選，默認為 7.0）
• ADO_API_MAX_RETRIES: API 調用的最大重試次數（可選，默認為 3）
• ADO_API_DELAY_MS: 重試之間的延遲時間（以毫秒為單位）（可選，默認為 1000）
• ADO_API_USE_KERBEROS: 是否啟用 Kerberos 認證（可選，默認為 false）

配置文件示例

# 配置文件路徑：config/azure-devops-mcp.properties

# Azure DevOps 組織名稱
organization.name = my_organization

# 默認項目 ID
project.id = 12345678-9abc-defg-1234-56789abcdef

# API 基 URL
api.url = https://dev.azure.com

# 個人訪問令牌
pat.token = your_personal_access_token_here

# 最大重試次數
max.retries = 3

# 重試延遲（毫秒）
retry.delay.ms = 1000

✨ 主要特性

• 可視化架構：通過項目結構圖和類圖，清晰展示 Azure DevOps MCP 的整體架構和組件關係。
• 多資源管理：支持對組織、項目、倉庫、管道等資源的管理和操作。
• 靈活配置：可通過環境變量和配置文件進行靈活配置。

📦 安裝指南

構建項目

mvn clean install -DskipTests

運行服務器

mvn spring-boot:run

Docker 鏡像構建

# 基礎鏡像
FROM openjdk:jdk17

# 設置工作目錄
WORKDIR /app

# 複製項目文件
COPY . .

# 打包應用
RUN mvn clean install -DskipTests && \
    cp target/azure-devops-mcp.jar .

# 運行應用
CMD ["java", "-jar", "target/azure-devops-mcp.jar"]

💻 使用示例

基礎用法

列出所有項目

{
    "id": "12345678-9abc-defg-1234-56789abcdef",
    "name": "MyProject",
    "description": "This is my project description.",
    "state": "active"
}

獲取倉庫信息

{
    "id": "repo_123",
    "name": "my_repository",
    "branches": [
        {
            "name": "main",
            "commit": {
                "sha": "abc123def456789",
                "message": "Initial commit"
            }
        }
    ],
    "pullRequests": [
        {
            "id": 1,
            "title": "Add feature X",
            "status": "open"
        }
    ]
}

📚 詳細文檔

項目結構圖

下圖展示了 Azure DevOps MCP 項目的整體架構：

類圖

以下是 Azure DevOps MCP 的類圖，展示了各個組件之間的關係和交互：

classDiagram

    class ADOrganization {
        string name
        string description
        void addProject()
        void removeProject()
        ProjectsList projects
    }

    class ADProject {
        string id
        string name
        string state
        Repository[] repositories
        Pipeline[] pipelines
    }

    class ProjectManager {
        ADProject currentProject
        void switchProject(string projectId)
        void createProject(ADProject project)
        void deleteProject(string projectId)
        ProjectsList listProjects()
    }

    class ADOrganization {
        <<Aggregate Root>>
        string name
        string description
        ADProject[] projects
    }

    class ADUser {
        string id
        string email
        string firstName
        string lastName
        Role role
    }

    class Repository {
        string id
        string name
        Branch[] branches
        PullRequest[] pullRequests
    }

    class Pipeline {
        string id
        string name
        string state
        Job[] jobs
    }

    class ADOrganizationRepository {
        void save(ADOrganization org)
        ADOrganization findById(string id)
        List<ADOrganization> findAll()
    }

    ProjectManager o -> ADOrganizationRepository: findCurrentOrganization()

    ProjectManager --> ADProject: CurrentProject

    ADUser --> Role: hasRole()

    ADProject --> Repository: getRepositories()

    ADProject --> Pipeline: getPipelines()

    Repository --> Branch: getBranches()

    Repository --> PullRequest: getPullRequests()

    Pipeline --> Job: getJobs()

📄 許可證

MIT 許可證

版權所有 (c) 2024 Azure DevOps MCP 開發團隊。

特此免費授予任何獲得本軟件及相關文檔文件（“軟件”）副本的人，允許其無限制地處理本軟件，包括但不限於使用、複製、修改、合併、發佈、分發、再許可和/或出售軟件副本的權利，並允許向其提供軟件的人這樣做，但須遵守以下條件：

上述版權聲明和本許可聲明應包含在所有軟件副本或重要部分中。

軟件按“原樣”提供，不附帶任何形式的明示或暗示保證，包括但不限於適銷性、特定用途適用性和不侵權的保證。在任何情況下，作者或版權持有人均不對因合同、侵權或其他方式引起的任何索賠、損害或其他責任負責，無論是在與軟件或軟件的使用或其他交易有關的任何行動中。

⚠️ 重要提示

如需商業用途，請聯繫開發團隊獲取授權。