Github Repository Inspector

🚀 MCP-Inspector-v0.6.0

このサーバーは Model Context Protocol (MCP) を実装しており、Claude などの人工知能アシスタントが GitHub リポジトリ、イシュー、プルリクエストとやり取りできるようにします。

✨ 主な機能

• リポジトリ検索：検索クエリに基づいて GitHub リポジトリを検索します。
• イシュー管理：イシューの取得、作成、コメントを行います。
• プルリクエスト処理：プルリクエストの表示と管理を行います。
• リポジトリ分析：リポジトリの統計情報と洞察を取得します。

📦 インストール

前提条件

• Python 3.8+
• GitHub APIトークン

手順

1. このリポジトリをクローンします：

   git clone https://github.com/yourusername/github-mcp-server.git
   cd github-mcp-server
   

2. 依存関係をインストールします：

   pip install -r requirements.txt
   

3. あなたの GitHub トークンを環境変数として設定します：

   export GITHUB_TOKEN=your_github_token_here
   

4. サーバーを起動します：

   python server.py
   

サーバーは http://localhost:5000 で起動します。

💻 使用例

エンドポイント

MCP サーバーは以下のエンドポイントを提供します：

• GET /mcp/discover：利用可能な操作とそのパラメータを返します。
• POST /mcp/execute：提供されたパラメータに基づいて操作を実行します。

リクエスト例

検出

curl -X GET http://localhost:5000/mcp/discover

リポジトリ検索の実行

curl -X POST http://localhost:5000/mcp/execute \
  -H "Content-Type: application/json" \
  -d '{
    "endpoint": "search_repositories",
    "parameters": {
      "query": "machine learning"
    }
  }'

リポジトリのイシューの取得

curl -X POST http://localhost:5000/mcp/execute \
  -H "Content-Type: application/json" \
  -d '{
    "endpoint": "get_repo_issues",
    "parameters": {
      "owner": "openai",
      "repo": "whisper"
    }
  }'

📚 ドキュメント

アーキテクチャ

サーバーは Model Context Protocol 規格に従っており、AI アシスタントが以下のことを可能にします：

1. 利用可能な操作を検出する
2. 適切なパラメータで操作を実行する
3. 結果を構造化された形式で処理して返す

サーバーの拡張

サーバーは以下の方法で拡張できます：

1. discover() 関数に新しいエンドポイントを追加する
2. 対応する処理関数を実装する
3. execute() 関数のルーティングを更新する

セキュリティに関する注意事項

• サーバーは API トークンを使用して GitHub 認証を行います。
• 乱用を防ぐためにレート制限を実装しています。
• すべてのパラメータに対して入力検証を行います。
• より安全なトークン管理のために OAuth の実装を検討してください。

デモ

サーバーの機能のデモは、デモビデオを参照してください。

📄 ライセンス

MIT License

お問い合わせ

質問やサポートが必要な場合は、このリポジトリでイシューを開いてください。