MCP Server Azure Devops

🚀 Azure DevOps MCP サーバー

Azure DevOps MCP（モデルコンテキストプロトコル）サーバーは、Azure DevOps サービスとのインタラクションに使用されるツールです。ユーザー管理、プロジェクト管理、コードリポジトリへのアクセス、ワークアイテム操作、検索機能、パイプライン管理、Wiki 操作、プルリクエスト管理など、さまざまな機能を提供します。

🚀 クイックスタート

前提条件

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
   

✨ 主な機能

サーバー構造

コアコンポーネント

• ユーザーツール
  • 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：プルリクエストにコメントを追加します（既存のコメントに返信または新しいスレッドを作成）。

📦 インストール

前提条件

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
   

💻 使用例

基本的な使用法

新しいワークアイテムの作成

const mcp = require('mcp-server-azure-devops');
mcp.createWorkItem({
  title: '新機能要件',
  description: '新しいユーザーストーリー機能を開発する。'
}, (error, workItem) => {
  if (error) {
    console.error('ワークアイテムの作成中にエラーが発生しました:', error);
  } else {
    console.log('ワークアイテムが作成されました。ID:', workItem.id);
  }
});

コードの検索

mcp.searchCode('Feature:X', (error, results) => {
  if (error) {
    console.error('コードの検索中にエラーが発生しました:', error);
  } else {
    console.log('見つかったファイル:', results.files);
  }
});

パイプラインの実行トリガー

mcp.triggerPipeline('main', 'master', (error, pipelineRun) => {
  if (error) {
    console.error('パイプラインのトリガー中にエラーが発生しました:', error);
  } else {
    console.log('パイプラインがトリガーされました。実行 ID:', pipelineRun.id);
  }
});

📚 ドキュメント

認証方式

実装詳細

認証モジュールはプロジェクトの 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
   

📄 ライセンス

このプロジェクトは MIT License の下で公開されています。

問題フィードバック

問題の提出

使用中に問題が発生した場合やヘルプが必要な場合は、以下の方法で問題を提出してください。

1. GitHub Issues：
   • プロジェクトリポジトリ にアクセスし、Issues セクションで問題を提出します。
2. メールでの連絡：
   • 開発チームに support@yourdomain.com までメールを送信してください。

更新履歴

最新バージョン

• v1.0.0：基本機能を含む初期バージョン。
• v1.1.0：OAuth サポートを追加し、いくつかの既知のエラーを修正。
• v1.2.0：パフォーマンスと安定性を向上させ、より多くの Azure DevOps 機能をサポート。