GitHub MCP Server

GitHub MCP Server

GitHub API と連携するための Model Context Protocol サーバーです。

機能

ツール

• list_user_repos：認証済みユーザーのリポジトリを一覧表示します

  • パラメーター：
    • type（任意）：「owner」、「all」、「member」のいずれか（デフォルト：「owner」）
    • sort（任意）：「created」、「updated」、「pushed」、「full_name」のいずれか（デフォルト：「full_name」）
    • direction（任意）：「asc」または「desc」（デフォルト：「asc」）
    • per_page（任意）：1ページあたりの結果数（デフォルト：30、最大：100）
    • page（任意）：ページ番号（デフォルト：1）

• get_repo：指定したリポジトリの詳細を取得します

  • パラメーター：
    • repo（必須）：リポジトリ名
    • owner（任意）：アカウントの所有者。指定しない場合は、認証済みユーザーが使用されます。

• create_repo：新しいリポジトリを作成します

  • パラメーター：
    • name（必須）：リポジトリ名
    • description（任意）：簡単な説明
    • private（任意）：リポジトリを非公開にするかどうか（デフォルト：false）
    • auto_init（任意）：空の README を含む初回コミットを作成するかどうか（デフォルト：false）

• create_commit：ファイルの変更を含む新しいコミットを作成します

  • パラメーター：
    • repo（必須）：リポジトリ名
    • owner（任意）：アカウントの所有者。指定しない場合は、認証済みユーザーが使用されます。
    • branch（任意）：ブランチ名（デフォルト：「main」）
    • message（必須）：コミットメッセージ
    • files（必須）：コミットに含めるファイルの配列
      • 各ファイルに必要な項目：
        • path：リポジトリのルートからの相対ファイルパス
        • content：ファイルの内容

• push：変更をリモートリポジトリにプッシュします

  • パラメーター：
    • repo（必須）：リポジトリ名
    • owner（任意）：アカウントの所有者。指定しない場合は、認証済みユーザーが使用されます。
    • branch（任意）：ブランチ名（デフォルト：「main」）

• pull：リモートリポジトリから変更をプルします

  • パラメーター：
    • repo（必須）：リポジトリ名
    • owner（任意）：アカウントの所有者。指定しない場合は、認証済みユーザーが使用されます。
    • branch（必須）：ブランチ名

要件

• Node.js 18+
• 適切な権限を持つ GitHub パーソナルアクセストークン
• 環境変数 GITHUB_TOKEN を設定します

インストール

npm install
npm run build

設定

GitHub トークンを環境変数として設定します：

export GITHUB_TOKEN=your_token_here

使い方

サーバーを実行します：

npm start

開発

自動再ビルドを有効にして開発する場合：

npm run watch

デバッグ

MCP Inspector を使用します：

npm run inspector