Ado MCP

🚀 Azure DevOps 多租户制御平面（MCP）

Azure DevOps 多租户制御平面（MCP）は、Azure DevOps の多租户環境を管理するためのシステムです。このシステムを使用することで、組織やプロジェクトの管理、ユーザーの認証、リポジトリやパイプラインの操作などを効率的に行うことができます。

🚀 クイックスタート

プロジェクト構造図

下図は、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()

✨ 主な機能

• 組織やプロジェクトの管理
• ユーザーの認証と権限管理
• リポジトリやパイプラインの操作

📦 インストール

環境変数の設定

• 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

💻 使用例

基本的な使用法

すべてのプロジェクトをリストする

{
    "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"
        }
    ]
}

📚 ドキュメント

開発ガイド

プロジェクトのビルド

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"]

📄 ライセンス

MIT ライセンス

Copyright (c) 2024 Azure DevOps MCP 開発チーム。

このソフトウェアおよび関連ドキュメントファイル（「ソフトウェア」）のコピーを取得するすべての人に対して、無料で、ソフトウェアを制限なく取り扱うことが許可されます。これには、使用、コピー、変更、マージ、公開、配布、サブライセンス、および/またはソフトウェアのコピーを販売する権利が含まれます。ただし、以下の条件に従うことを条件とします。

上記の著作権表示とこの許諾表示は、ソフトウェアのすべてのコピーまたは実質的な部分に含まれる必要があります。

ソフトウェアは「現状のまま」提供され、明示または黙示を問わず、商品性、特定の目的への適合性、および非侵害性の保証を含む、いかなる種類の保証もないものとします。いかなる場合も、著者または著作権者は、契約、不法行為、またはその他の方法による、ソフトウェアまたはソフトウェアの使用またはその他の取引に関連するいかなる請求、損害、またはその他の責任についても、責任を負わないものとします。

⚠️ 重要な注意

商用利用の場合は、開発チームに連絡して許可を取得してください。