Azuredevops MCP

🚀 Azure DevOps MCP サーバーガイド

MCP（マシンクラスプロトコル）は、Azure DevOpsサービスとのやり取りに使用されるプロトコルです。このサーバーを使用することで、様々な開発タスクを自動化および管理することができます。

🚀 クイックスタート

このガイドでは、Azure DevOps MCPサーバーの設定と使用方法について説明します。これにより、開発プロセスの自動化管理を実現できます。

✨ 主な機能

• 開発タスクの自動化と管理
• 複数の認証方法をサポート
• サービス層とツール層による機能の分離

📦 インストール

プロジェクトの設定

認証設定

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：リリースパイプラインを管理し、環境構成を実行します。

サンプルコード

// 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);
  }
}

ツール層

ツールの実装

• GitTools：コードリポジトリ操作インターフェースを提供し、listRepositories、getBranchesなどがあります。
• BuildTools：ビルド関連の機能をカプセル化し、queueBuild、getBuildStatusなどがあります。

構成管理

プロジェクト構成は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();
   }
   

高度な使用法

トラブルシューティング

一般的な問題

• 認証エラー：

  • 個人用アクセストークンが有効で、正しいアクセス許可があることを確認してください。
  • 組織URLが正しいことを確認してください。

• TypeScriptコンパイルエラー：

  • npm run build:ignore-errorsを使用して型チェックをスキップします。
  • 欠落または誤った型定義がないか確認してください。

コントリビューションガイド

コントリビューションを歓迎します！以下の手順に従ってください。

1. リポジトリをフォークする
2. 機能ブランチを作成する：

   git checkout -b feature/amazing-feature
   

3. 変更をコミットする：

   git add .
   git commit -m "新機能の追加"
   

4. GitHubにプッシュする：

   git push origin feature/amazing-feature
   

📄 ライセンス

このプロジェクトはMITライセンスに準拠しており、詳細はLICENSEファイルを参照してください。