Phialsbasement MCP Github Server Plus

🚀 GitHub MCP サーバーガイド

このプロジェクトは、GitHub MCP サーバーの使用方法を案内するドキュメントです。Docker を用いたインストール、サポートされる Git コマンドや GitHub API コマンド、コード検索コマンドなど、さまざまな機能の使い方を説明しています。

🚀 クイックスタート

📦 インストール

Docker のインストールとサービスの起動

イメージのダウンロード

docker pull mcp/github

サービスの起動

docker run -i --rm -e GITHUB_PERSONAL_ACCESS_TOKEN=mYnGfGhp0c3oQ9cd8w5DZvxnWiawQjxOls -p 1234:1234 mcp/github

💻 使用例

基本的な使用法

サポートされる Git コマンド

リポジトリ情報の取得

git ls-remote https://github.com/username/repo.git

新しいブランチの作成

git branch new-feature -f origin/main:main

変更のコミット

git push https://x-access-token:<TOKEN>@github.com/username/repo.git main

サポートされる GitHub API コマンド

ユーザー情報の取得

GET /users/{username}

リポジトリ情報の取得

GET /repos/{owner}/{repo}

新しいブランチの作成

POST /repos/{owner}/{repo}/branches

サポートされるコード検索コマンド

言語で検索

language:javascript

リポジトリパスで検索

repo:owner/name

ファイルパスで検索

path:app/src

高度な使用法

コードの検索

q: "import express" language:typescript path:src/

問題の検索

q: "memory leak" is:issue is:open label:bug

ユーザーの検索

q: "fullstack developer" location:London followers:>100

📚 ドキュメント

個人アクセストークンの設定

GitHub 個人アクセストークンを作成します。

• GitHub アカウントにログインし、「開発者設定」>「個人アクセストークン」にアクセスします。
• 新しいトークンを生成し、「repo」スコープの権限を付与します。

Docker 設定例

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

NPX 設定例

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-github"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

イメージのビルド

docker build -t mcp/github -f src/github/Dockerfile .

設定と構成

個人アクセストークン

個人アクセストークンを作成し、適切な権限（「repo」スコープなど）を持つように構成します。

Claude Desktop への統合

claude_desktop_config.json に GitHub MCP サーバーの設定を追加します。

✨ 主な機能

サポートされるコマンド

• リポジトリ情報：リポジトリのコミット、ブランチ、タグ情報を取得します。
• コード検索：言語フィルタリング、パス制限、ファイル拡張子のフィルタリングをサポートします。
• 問題管理：オープンまたはクローズされた問題を検索し、ラベルで分類します。
• プルリクエスト：マージ状態とチェック結果を確認します。
• コメントとレビュー：コードのコメントとレビュー意見を取得します。

🔧 技術詳細

この GitHub MCP サーバーは、Docker を使用してインストールおよび管理されます。GitHub API を利用して、さまざまな操作を行うことができます。

📄 ライセンス

この MCP サーバーは MIT ライセンスの下で提供されています。これは、ソフトウェアを自由に使用、変更、配布できることを意味しますが、MIT ライセンスの条項と条件に従う必要があります。詳細については、プロジェクトリポジトリの LICENSE ファイルを参照してください。

💡 使用提案

このプロジェクトへの貢献を歓迎します。リポジトリをフォークし、Pull Request を送信してください。何か問題があれば、Issues で報告してください。