slim-github-mcp

読み取り専用のGitHub MCPサーバーで、小さな結果を返します。

ほとんどのGitHub MCPサーバーは、モデルに生のGitHub APIオブジェクトを渡します。それは高速なAPIの背後にあるフロンティアモデルには問題ありませんが、ローカルモデルには苦痛です。リポジトリ検索結果の1ページはおよそ**14KBのJSON（約3.5kトークン）**で、その大半は誰も読まないURLと権限フラグです。さらにツールスキーマが約7kトークン加わると、ローカルホストのモデルは「リポジトリを一覧表示」に数分かかるか、または終わらないこともあります。

このサーバーは逆の立場を取ります。すべてのツールは役に立つフィールドを少しだけ返し、すべてのリストはサーバー側で上限が設定され、ツールの全体は9つの関数だけです。モデルは、どんな引数をでっち上げても、巨大なペイロードを取得できません。

ツール

すべてのlimitはデフォルトで 10 と、30 でクランプされます。gh_file は20k文字を超えると切り詰め、truncated フラグでその旨を知らせます。リポジトリは full_name、private、160文字の description、language、stars、updated、url — それ以外は返しません。

意図的に書き込み経路はありません。クライアントは api.github.com に対して GET を送るだけです。

Related MCP server: GitHub MCP Server

GitHubトークンを取得する

サーバーには1つのトークンが必要で、すべての呼び出しに使用します。読み取りアクセスのみが必要です。

1. GitHub → Settings → Developer settings → Personal access tokens → Fine-grained tokens → Generate new token に移動します。

2. 有効期限を設定し、トークンがアクセスできるリポジトリを選択します — Public repositories only にすればプライベートデータがGitHubの外に出ることはありません。また gh_my_repos(visibility="private") を使いたい場合は All repositories を選びます。

3. Repository permissions で、実際に必要なものへの読み取り専用アクセスを許可します:

   • Metadata: Read-only — 必須で、リポジトリ一覧と検索に十分です。

   • Contents: Read-only — gh_file と gh_commits 用です。

   • Issues: Read-only — gh_issues 用です。

   • Pull requests: Read-only — gh_pulls 用です。

4. Account permissions はすべてそのままにします。

5. トークンをコピーします。GitHub が表示するのは一度だけです。

repo スコープを持つクラシックトークンでも動作しますが、このサーバーに必要な範囲よりかなり広いため、fine-grained トークンを推奨します。

未認証のGitHub API呼び出しは1時間あたり60リクエストの制限があるため、実際にはトークンなしでは話にりません。トークンがあれば1時間あたり5,000リクエストできます。

インストール

git clone https://github.com/0xBakeer/slim-github-mcp.git
cd slim-github-mcp

python3 -m venv venv
./venv/bin/pip install -r requirements.txt

cp .env.example .env
$EDITOR .env            # put your token in GITHUB_MCP_TOKEN

実行します:

set -a; . ./.env; set +a
./venv/bin/uvicorn slim_github_mcp.main:app --host 127.0.0.1 --port "${GITHUB_MCP_PORT:-9130}"

起動してトークンが機能することを確認します:

curl -s http://127.0.0.1:9130/api/health
curl -s -H "Authorization: Bearer $GITHUB_MCP_SECRET" \
     'http://127.0.0.1:9130/api/my-repos?visibility=public&limit=5'

MCPエンドポイント自体は次のとおりです:

http://127.0.0.1:9130/tools/mcp/v1

ストリーミングHTTPを話すため、URLを受け付けるMCPクライアントならどれでも使えます。

設定

ポートがlocalhost以外から到達できる場合は GITHUB_MCP_SECRET を必ず設定してください。 サーバーはあなたのプライベートリポジトリを読み取れる可能性のあるトークンを保持しており、それ以外の場合、呼び出し元を認証しません。openssl rand -hex 24 で生成できます。

GITHUB_MCP_PUBLIC_HOST があるのは、MCPがデフォルトでDNSリバインディング保護を有効にするためです。リバースプロキシから届いたリクエストは、公開された Host ヘッダーを持ち、そのホスト名が宣言されていない限り拒否されます。忘れると、/api/health は正常なのにMCPエンドポイントだけ 400 を返すという症状が出ます。

サービスとして実行する

scripts/github-mcp.service はsystemdユニットで、User とパスを設定し、EnvironmentFile を上記の変数を保持するroot所有の 0600 ファイルに指定します。トークン はユニットファイル自体には置かないでください。

Dockerfile もあります:

docker build -t slim-github-mcp .
docker run -d --name github-mcp -p 127.0.0.1:9130:9130 --env-file .env slim-github-mcp

リバースプロキシの裏で使う

複雑なことはありません。ただしMCPのストリームを維持するため、バッファリングは必ずオフにします:

location /tools/mcp/ {
    proxy_pass http://127.0.0.1:9130;
    proxy_set_header Host $host;
    proxy_http_version 1.1;
    proxy_buffering off;
    proxy_cache off;
    proxy_read_timeout 3600s;
}

GITHUB_MCP_PUBLIC_HOST をプロキシ元のホスト名に設定します。

Open WebUI で使う

Open WebUIはMCPをネイティブに話せます（0.6.x 以降）。ヘルパースクリプトでサーバーを登録します:

export OPEN_WEBUI_URL=https://webui.example.com
export OPEN_WEBUI_KEY=sk-...                      # Settings -> Account -> API keys
export GITHUB_MCP_URL=http://127.0.0.1:9130/tools/mcp/v1
export GITHUB_MCP_SECRET=...                      # if you set one

./scripts/register-open-webui.sh

既存のツールサーバーとIDでマージされるため、再実行すると更新されます。そのあと、検出したツールを出力します:

==> Verifying tool discovery
    9 tools: gh_whoami, gh_my_repos, gh_user_repos, ...

手動で行う場合: Admin Settings → Tools → Add Other Server、タイプは MCP、URLは上のURL、Auth はシークレットを Bearer で指定します。

見落としやすい点が2つあります:

• チャットのツールピッカーでツールを有効にする。 登録したサーバーが自動的に選択されるわけではありません。

• モデルごとにツールを固定している場合（Workspace → Models → Tools）、そこにも追加してください。Open WebUI では server:mcp:<id> として保存されます。あとでサーバーを id を変更すると固定参照は静かに消え、モデルはツールなしで、推測で答えます。

知っておくと良い点: tool_ids 付きで直接 /api/chat/completions を呼び出しても、ツールサーバーは接続されません。ツールの配線はフロントエンドで行われるため、UI 経由でテストしてください。

ライセンス

MIT