GitHub Repository MCP Server

GitHub Repository MCP サーバー

この Model Context Protocol（MCP）サーバーを使用すると、AI モデルがコンテキストとして GitHub リポジトリの内容にアクセスできます。AI とのやり取りでコンテキストとして利用できるよう、ファイルの内容、リポジトリの構造、リポジトリ全体を取得するツールを提供します。

特長

• リポジトリ全体の内容をコンテキストとして取得
• リポジトリ内の特定のファイルの内容を取得
• リポジトリの構造（ファイル一覧）を取得
• 拡張子でファイルを絞り込み
• 特定のパスを除外
• 返されるファイル数を制限

インストール

# clone the repository
git clone https://github.com/shanksxz/github-mcp.git
cd github-mcp

# install dependencies
npm install

# build the project
npm run build

使用方法

GitHub 認証の設定

認証なしでもパブリックリポジトリを利用できますが、GitHub API では認証されていないリクエストに厳しいレート制限（1 時間あたり 60 リクエスト）があります。この制限を 1 時間あたり 5000 リクエストに増やすには、GITHUB_TOKEN 環境変数を設定します。

# create a file called gh.sh and add the following line:
export GITHUB_TOKEN=your_github_personal_access_token
# make the file executable
chmod +x gh.sh
# run the file
./gh.sh

GitHub Developer Settingsで個人用アクセストークンを作成できます。

Cursor での使用

このサーバーを Cursor で使用するには、次の手順に従います。

1. Cursor Settings を開きます
2. 「MCP」を検索します
3. 「Add a new MCP Server」をクリックします
4. 次の情報を入力します
   • 名前：github-repo-context（または任意の名前）
   • 種類：Command
   • コマンド：/path/to/your-local-repo-setup/gh.sh
5. 「Save」をクリックします
6. サーバー名の横にある切り替えボタンをクリックして、サーバーを有効にします
7. これで、プロジェクトでサーバーを使用できるようになります

このサーバーは、MCP プロトコルに従って stdin/stdout 経由で通信します。

利用可能なツール

このサーバーは、次のツールを提供します。

1. get-repo-context：コンテキストとして使用するため、GitHub リポジトリのすべてのファイルを取得します

   • パラメーター：
     • owner：GitHub リポジトリの所有者または組織名
     • repo：GitHub リポジトリ名
     • maxFiles（任意）：含めるファイルの最大数（デフォルト：50）
     • fileExtensions（任意）：含めるファイルの拡張子（例：['js', 'ts', 'md']）
     • excludePaths（任意）：除外するパス（デフォルト：['node_modules', 'dist', 'build']）

2. get-file-content：GitHub リポジトリ内の特定のファイルの内容を取得します

   • パラメーター：
     • owner：GitHub リポジトリの所有者または組織名
     • repo：GitHub リポジトリ名
     • path：リポジトリ内のファイルへのパス

3. get-repo-structure：GitHub リポジトリの構造を取得します

   • パラメーター：
     • owner：GitHub リポジトリの所有者または組織名
     • repo：GitHub リポジトリ名

例

MCP に対応した AI モデルと統合すると、次のようなコマンドを使用できます。

Get the structure of the repository tensorflow/tensorflow

その後、AI は get-repo-structure ツールを使用して、リポジトリの構造を取得し、表示します。