Dockerized GitHub MCP Server

GitHubのAPIと連携し、リポジトリのファイル操作、リポジトリ管理、検索機能などを提供するModel Context Protocol（MCP）サーバーをDockerコンテナとして提供します。

機能

• 自動ブランチ作成: ファイル作成/更新時やpush時に、存在しないブランチを自動的に作成
• 包括的なエラーハンドリング: 一般的な問題に対する明確なエラーメッセージを提供
• Gitヒストリー保持: 操作は強制pushを使わず適切なGitヒストリーを維持
• バッチ操作: 単一ファイルと複数ファイルの両方の操作をサポート
• 高度な検索: コード、イシュー/PR、ユーザーの検索をサポート

セットアップ

1. GitHub Personal Access Tokenの準備

1. GitHub Personal Access Tokenを作成します

   • GitHubの設定 > 開発者設定 > Personal access tokenに移動
   • このトークンがアクセスできるリポジトリを選択（Public、All、または特定のリポジトリ）
   • repoスコープ（「プライベートリポジトリの完全な制御」）を選択
     • または、公開リポジトリのみを操作する場合はpublic_repoスコープのみを選択
   • 生成されたトークンをコピー

2. .envファイルにトークンを設定:

   GITHUB_PERSONAL_ACCESS_TOKEN=ghp_your_token_here
   

2. Dockerによるビルドと起動

ビルド手順

# Dockerイメージのビルド
docker build -t mcp/github -f src/github/Dockerfile .

起動手順（docker runの場合）

docker run -it --rm -e GITHUB_PERSONAL_ACCESS_TOKEN=$GITHUB_PERSONAL_ACCESS_TOKEN -p 5000:5000 mcp/github

複数コンテナ起動（docker-compose）

# .envファイルを作成してトークンを設定
cp .env.template .env
# 環境変数を編集
nano .env
# 起動
docker-compose up -d

これにより、2つの異なるポート（5002と5003）でGitHub MCPサーバーが起動します。 コンテナはttyモードで起動し、stdioインターフェースを通じて通信を待機します。

3. Cursorでの使用方法

MCPサーバーは標準入出力（stdio）を介して通信するように設計されています。Cursorと連携するには、claude_desktop_config.jsonに以下の設定を追加してください：

{
  "mcpServers": {
    "github": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GITHUB_PERSONAL_ACCESS_TOKEN",
        "mcp/github"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_your_token_here"
      }
    }
  }
}

この設定により、Cursorが必要なときにだけMCPサーバーを起動し、処理が完了すると自動的に終了します。

使用方法

MCPサーバーは、ツール名とその入力パラメータを含むメッセージ形式でリクエストを受け付けます。

リクエスト例（/respond エンドポイント）

ファイルの作成または更新

curl -X POST http://localhost:5002/respond \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [
      {
        "role": "user",
        "content": {
          "tool_name": "create_or_update_file",
          "input": {
            "owner": "your-username",
            "repo": "your-repo",
            "path": "example.txt",
            "content": "Hello, world!",
            "message": "Add example file",
            "branch": "main"
          }
        }
      }
    ]
  }'

リポジトリ検索

curl -X POST http://localhost:5002/respond \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [
      {
        "role": "user",
        "content": {
          "tool_name": "search_repositories",
          "input": {
            "query": "modelcontextprotocol"
          }
        }
      }
    ]
  }'

ファイル内容取得

curl -X POST http://localhost:5002/respond \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [
      {
        "role": "user",
        "content": {
          "tool_name": "get_file_contents",
          "input": {
            "owner": "octocat",
            "repo": "Hello-World",
            "path": "README.md"
          }
        }
      }
    ]
  }'

サポートしているツール

GitHub MCPサーバーは以下の機能を提供します：

1. create_or_update_file - リポジトリに単一ファイルを作成/更新
2. push_files - 複数ファイルを一度のコミットでプッシュ
3. search_repositories - GitHubリポジトリを検索
4. create_repository - 新しいGitHubリポジトリを作成
5. get_file_contents - ファイルまたはディレクトリの内容を取得
6. create_issue - 新しいイシューを作成
7. create_pull_request - 新しいプルリクエストを作成
8. fork_repository - リポジトリをフォーク
9. create_branch - 新しいブランチを作成
10. list_commits - ブランチのコミット一覧を取得
11. list_issues - リポジトリのイシュー一覧を取得
12. update_issue - 既存のイシューを更新
13. add_issue_comment - イシューにコメントを追加
14. search_code - コードを検索
15. search_issues - イシューとプルリクエストを検索
16. search_users - GitHubユーザーを検索
17. get_issue - 特定のイシューの詳細を取得
18. get_pull_request - 特定のプルリクエストの詳細を取得
19. list_pull_requests - プルリクエスト一覧を取得
20. create_pull_request_review - プルリクエストのレビューを作成
21. merge_pull_request - プルリクエストをマージ
22. get_pull_request_files - プルリクエストの変更ファイル一覧を取得
23. get_pull_request_status - プルリクエストのステータスを取得
24. update_pull_request_branch - プルリクエストのブランチを更新
25. get_pull_request_comments - プルリクエストのコメントを取得
26. get_pull_request_reviews - プルリクエストのレビューを取得

詳細な各ツールの入力パラメータや使用方法については、公式リポジトリのドキュメントを参照してください。

注意事項

• アクセストークン: GitHub Personal Access Tokenは必要なスコープ（repoまたはpublic_repo）を持つものを使用してください。APIレート制限にも注意してください。
• リクエスト形式: MCPのプロトコルに準拠し、各メッセージはroleとcontent（中にtool_nameとinput）を含む必要があります。
• stdioモード: このMCPサーバーはHTTPサーバーではなく、標準入出力（stdio）を介して通信するよう設計されています。Cursorなどのツールから呼び出して使用するのが最適です。

ライセンス

このプロジェクトは、元のMCP serverと同じMITライセンスのもとで提供されています。