Game Industry Library

gil-mcp-bridge

Game Industry Library MCP サーバー向けの Stdio ブリッジです。リモートの /api/mcp エンドポイントを、ローカルコマンド（stdio）のみを実行できる MCP クライアント（旧バージョンの Claude Desktop、Cline、Continue、旧バージョンの Cursor、カスタム連携）に公開します。

クライアントがサーバーアドレスを指定できる場合（HTTP 経由のリモート MCP — Claude アプリと claude.ai、ChatGPT、Claude Code、Cursor）は、ブリッジを使わずに https://gameindustrylibrary.com/api/mcp に直接接続してください。OAuth でサインインするため、ブリッジは不要です。/help/mcp-server のガイド付きセットアップで、各クライアントの設定手順を確認できます。

Game Industry Library Pro が必要です。 誰でもサインインできますが、有効なサブスクリプションがない場合、ツールの呼び出しはその旨を示すエラーになります。サブスクリプションを申し込む。

インストール

npx を使って GitHub から直接実行できます。インストールは不要です。

npx --yes --allow-git=root github:DerpBicycle/gil-mcp-bridge

npm 12 以降では、許可されていない Git から取得したパッケージを拒否するため（EALLOWGIT）、--allow-git=root が必要です。古いバージョンの npm でもこのフラグは使えるため、すべてのコマンドと設定に含めてください。--yes を指定すると、インストールの確認を省略できます。

または、特定のコミット／タグを指定します。

npx --yes --allow-git=root github:DerpBicycle/gil-mcp-bridge#v0.2.0

または、クローンしてインストールします。

git clone https://github.com/DerpBicycle/gil-mcp-bridge
cd gil-mcp-bridge
npm install   # runs prepare → tsc, then dist/ is ready
node dist/index.js

認証

次の 2 つの方法があります。

OAuth（推奨）

npx --yes --allow-git=root github:DerpBicycle/gil-mcp-bridge login

ブラウザーが開き、DCR でクライアントが登録され、同意画面の案内が表示されます。トークンは ~/.gil/credentials.json（モード 0600、ユーザーのみアクセス可能）に保存されます。アクセストークンの有効期間は 1 時間で、自動的に更新されます。/account → Connected Apps から取り消すか、logout を実行しない限り、セッションは 30 日間有効です。

API キー

GIL_API_KEY=gil_xxx npx --yes --allow-git=root github:DerpBicycle/gil-mcp-bridge

/help/mcp-server でキーを作成してください（Pro に加入してサインインしている必要があります）。キーに有効期限はありませんが、同じページから取り消すことができます。

MCP クライアントでの使用

Claude Desktop

Settings → Developer → Edit Config（claude_desktop_config.json）を開き、次の内容を追加します。

{
  "mcpServers": {
    "game-industry-library": {
      "command": "npx",
      "args": ["--yes", "--allow-git=root", "github:DerpBicycle/gil-mcp-bridge"]
    }
  }
}

Claude Desktop を再起動します。初回実行時、ブリッジは「no credentials」エラーを出力します。ターミナルで npx --yes --allow-git=root github:DerpBicycle/gil-mcp-bridge login を一度実行してサインインしてください。

Cline／Continue／その他の stdio クライアント

同じ設定を使用します。コマンドとして npx --yes --allow-git=root github:DerpBicycle/gil-mcp-bridge を指定してください。

カスタム

stdin で改行区切りの JSON-RPC 2.0 を送信します（単一のメッセージ、または最大 20 件のリクエストのバッチに対応）。応答は 1 行ずつ stdout に返されます。エラーとステータスメッセージは stderr に出力されます。

利用できる機能

サーバーの名前とロゴは initialize 応答に含まれ、モデル向けのリサーチ指示も返されます。

• ツール： search、fetch、search_in_document、get_document、get_pages、list_documents、list_recent、list_popular、list_tags、get_facets、get_figures、get_tables、get_entities、get_citation、get_similar、get_related、list_collections、list_writers、get_glossary_term
• リソース： gil://documents/{slug}、gil://documents/{slug}/page/{page}、gil://documents/{slug}/figures、gil://collections/{slug}、gil://writers/{slug}、gil://glossary/{term}
• プロンプト： summarize_document、compare_publishers、find_evidence、catch_up

公平利用の上限は、1 ユーザーあたり、すべてのキーとトークンを通じて、1 日 2,000 回のツール呼び出し（UTC の午前 0 時にリセット）および 1 分あたり 30 回です。各ツールの結果では、_meta.usage に残りの利用回数が示されます。

コマンド

gil-mcp                Start the bridge (default — use this in client config)
gil-mcp login          Interactive OAuth login (stores ~/.gil/credentials.json)
gil-mcp logout         Revoke and remove stored credentials
gil-mcp status         Show current credential state
gil-mcp help           Show help

環境変数

変数	用途	デフォルト
GIL_API_KEY	API キー（gil_…）。OAuth より優先されます。	—
GIL_BASE_URL	サーバー URL を上書きします。ステージング環境やローカル開発環境に対するテストに便利です。	https://gameindustrylibrary.com

仕組み

このブリッジは、薄いトランスポート変換レイヤーです。stdin から JSON-RPC フレームを読み取り、それぞれを Authorization: Bearer ヘッダー付きの POST /api/mcp（Streamable HTTP、プロトコル 2025-03-26）として転送し、initialize 時にサーバーが発行する Mcp-Session-Id をそのまま返します。サーバーの応答が JSON でも SSE ストリームでも、応答はそれぞれ 1 行として stdout に返されます。キャッシュも変換も行わず、処理はすべてサーバーが担います。

• トークンはリクエストごとに解決されます。有効期限まで 60 秒以内の OAuth トークンは先に更新されます。サーバーから 401 で拒否されたトークンは 1 回更新し、リクエストを再試行します。サーバーはトークンを使用するたびにリフレッシュトークンをローテーションするため、同時リクエストでは更新処理を共有します。更新に失敗すると、もう一度 login を実行するよう促すエラーがリクエストに返されます。
• エラーはサーバーからそのまま渡されます。Pro なしでの 403 や、公平利用の上限に達した際の 429 は、サーバーが書き込む JSON-RPC エラーとして返されます。JSON-RPC 形式でないもの（プロキシの HTML エラーページやネットワーク障害など）は、フレーム内の各リクエストに対する JSON-RPC エラーになります。そのため、クライアントが応答を待ち続けたり、不正なデータを読み取ったりすることはありません。
• シャットダウン： stdin が閉じると、ブリッジは処理中のリクエストに応答してから終了します。

ソースからビルドする

git clone https://github.com/DerpBicycle/gil-mcp-bridge
cd gil-mcp-bridge
npm install
npm run build
node dist/index.js

ファイル

• src/index.ts — CLI エントリーポイント、コマンドの振り分け
• src/bridge.ts — stdio ↔ HTTP の転送
• src/login.ts — OAuth の対話型フロー（DCR + PKCE + ループバック）
• src/credentials.ts — ~/.gil/credentials.json の読み取り／書き込み／更新／取り消し
• assets/ — Game Industry Library のロゴ（SVG、512 px および 192 px の PNG）

ライセンス

MIT