GitHub MCP Server

GitHub MCP サーバー

GitHub のリポジトリ、イシュー、ディスカッションなどとシームレスに連携できるように設計された、多用途で強力な Model Context Protocol（MCP）のサーバー実装です。このサーバーは、GitHub のデータを検索、更新、分析するための構造化されたインターフェースを提供し、効率的な管理、自動化、コラボレーションの強化を実現します。カスタムワークフローとの統合、リポジトリのメタデータの処理、イシューやディスカッションとのリアルタイムなやり取りに対応しており、開発者やチームが GitHub の利用を効率化できるよう支援します。ツールの構築、タスクの自動化、GitHub エコシステムとの新たな関わり方の模索など、どのような目的でも、このサーバーはプロジェクトの強固な基盤となります。

概要

この MCP サーバーは、AI アシスタントと GitHub API の橋渡しをし、AI モデルが次のような操作を行えるようにします。

• リポジトリの検索
• ディスカッションの表示
• リポジトリのアクティビティの分析
• リポジトリの統計情報の取得

機能

• リポジトリ管理：GitHub リポジトリの検索、分析、操作
• ディスカッション連携：GitHub Discussions の分析
• アクティビティ分析：リポジトリのアクティビティや貢献に関するインサイトの取得
• 検索機能：リポジトリ、コード、ディスカッションの高度な検索

インストール

前提条件

• Python 3.8+
• 適切な権限を持つ GitHub Personal Access Token

セットアップ

1. リポジトリをクローンします。

   git clone https://github.com/jasona7/mcp_github_discussions.git
   cd mcp_github_discussions
   

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

   pip install requests
   

3. 環境変数に GitHub トークンを設定します。

   export GITHUB_TOKEN=your_github_personal_access_token
   

使い方

サーバーの起動

次のコマンドでサーバーを起動します。

python scripts/mcp/github/mcp_github_server.py

サーバーはデフォルトで localhost:8004 で起動します。

利用可能なツール

サーバーでは次のツールを利用できます。

• search_repositories：さまざまな条件でリポジトリを検索
• get_repository_details：リポジトリの詳細情報を取得
• get_repository_issues：リポジトリのイシューを取得
• get_repository_discussions：リポジトリのディスカッションを取得
• get_top_repos_by_activity：アクティビティを基準にトレンドのリポジトリを取得

設定

サーバーは環境変数を使用して設定できます。

• GITHUB_TOKEN：GitHub Personal Access Token
• MCP_HOST：サーバーをバインドするホスト（デフォルト：localhost）
• MCP_PORT：サーバーをバインドするポート（デフォルト：8004）

クライアントの使用

python scripts/mcp/github/mcp_github_client.py
╭──────────────────────────────── GitHub Discussions Explorer ────────────────────────────────╮
│ MCP GitHub Discussions Explorer                                                             │
│ A terminal UI for interacting with GitHub Discussions                                       │
╰─────────────────────────────────────────────────────────────────────────────────────────────╯
Connecting to server...
Connected to server. 5 tools available.

Available Actions:
1. Browse Top Repositories
2. List Discussions (by repo)
3. Get Discussion Details
4. Check Server Status
5. Exit
6. Toggle Debug Mode
Enter the number of the action you want to perform [1/2/3/4/5/6] (1): 1

Browse Top Repositories:
1. Top Repos by Recent Activity
2. Top Repos by Star Count
3. Top Python Repos
4. Top JavaScript Repos
5. Top AI/LLM Repos
6. Back to Main Menu
Select repository category [1/2/3/4/5/6] (1): 3
Number of repositories to show (10): 3
Finding top Python repositories...
                             Top Repositories (3)                             
┏━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━━━━━━━━━┓
┃ # ┃ Repository                       ┃ Stars  ┃ Language ┃ Has Discussions ┃
┡━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━━━━━━━━━┩
│ 1 │ public-apis/public-apis          │ 334406 │ Python   │ ✗               │
│ 2 │ donnemartin/system-design-primer │ 294897 │ Python   │ ✗               │
│ 3 │ vinta/awesome-python             │ 238668 │ Python   │ ✗               │
└───┴──────────────────────────────────┴────────┴──────────┴─────────────────┘
None of the repositories have discussions enabled.

Available Actions:
1. Browse Top Repositories
2. List Discussions (by repo)
3. Get Discussion Details
4. Check Server Status
5. Exit
6. Toggle Debug Mode
Enter the number of the action you want to perform [1/2/3/4/5/6] (1): 

トラブルシューティング

• 接続拒否：サーバーが実行中であり、ファイアウォールによってポートがブロックされていないことを確認してください
• 認証エラー：GitHub トークンに必要な権限があることを確認してください
• レート制限：GitHub API にはレート制限があります。サーバーはこれに対応しますが、利用が集中すると処理が遅くなる場合があります

ライセンス

MIT License — 詳細は LICENSE ファイルを参照してください