{
  "markdown": "# gil-mcp-bridge\n\nStdio bridge for the **Game Industry Library MCP server**. Exposes the remote `/api/mcp` endpoint to MCP clients that only speak stdio (older Claude Desktop, Cline, Continue, custom integrations).\n\nIf your MCP client supports remote/HTTP transport (Claude Desktop ≥ 1.x, Claude.ai web, ChatGPT Connectors), you can connect directly without this bridge — see [the help page](https://gameindustrylibrary.com/help/mcp-server) for one-click connect instructions.\n\n## Install\n\nRun directly from GitHub via `npx` — no install needed:\n\n```bash\nnpx github:DerpBicycle/gil-mcp-bridge\n```\n\nOr pin a specific commit / tag:\n\n```bash\nnpx github:DerpBicycle/gil-mcp-bridge#v0.1.0\n```\n\nOr clone + install:\n\n```bash\ngit clone https://github.com/DerpBicycle/gil-mcp-bridge\ncd gil-mcp-bridge\nnpm install   # runs prepare → tsc, then dist/ is ready\nnode dist/index.js\n```\n\n## Authentication\n\nTwo options:\n\n### OAuth (recommended)\n\n```bash\nnpx github:DerpBicycle/gil-mcp-bridge login\n```\n\nThis opens your browser, registers a client via DCR, walks you through the consent screen, and stores tokens at `~/.gil/credentials.json` (mode 0600, user-only). Refresh happens automatically — your session stays valid for 30 days unless you revoke it from `/account → Connected Apps`.\n\n### Legacy API key\n\n```bash\nGIL_API_KEY=gil_xxx npx github:DerpBicycle/gil-mcp-bridge\n```\n\nGet a key from [/help/mcp-server](https://gameindustrylibrary.com/help/mcp-server) (logged in). Bearer keys don't expire but you can revoke them from the same page.\n\n## Use in your MCP client\n\n### Claude Desktop\n\nEdit `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows):\n\n```json\n{\n  \"mcpServers\": {\n    \"game-industry-library\": {\n      \"command\": \"npx\",\n      \"args\": [\"github:DerpBicycle/gil-mcp-bridge\"]\n    }\n  }\n}\n```\n\nRestart Claude Desktop. On first run, the bridge will print a \"no credentials\" error — run `npx github:DerpBicycle/gil-mcp-bridge login` once to authenticate.\n\n### Cline / Continue / other VS Code clients\n\nSame config — point the client at `npx github:DerpBicycle/gil-mcp-bridge` as the command.\n\n### Custom\n\nSpeak newline-delimited JSON-RPC 2.0 to stdin; receive responses on stdout. Errors and status messages go to stderr.\n\n## Commands\n\n```\ngil-mcp                Start the bridge (default — use this in client config)\ngil-mcp login          Interactive OAuth login (stores ~/.gil/credentials.json)\ngil-mcp logout         Remove stored credentials\ngil-mcp status         Show current credential state\ngil-mcp help           Show help\n```\n\n## Environment variables\n\n| Variable | Purpose | Default |\n|----------|---------|---------|\n| `GIL_API_KEY` | Legacy bearer key. Takes precedence over OAuth. | — |\n| `GIL_BASE_URL` | Override server URL. Useful for testing against staging or local dev. | `https://gameindustrylibrary.com` |\n\n## How it works\n\nThe bridge is a thin transport translator — ~80 lines of code per file. It reads JSON-RPC frames on stdin, forwards them as `POST /api/mcp` with a `Authorization: Bearer` header, and writes the response back to stdout. No caching, no retry, no transformation. The server does all the work.\n\nOAuth tokens are refreshed automatically when they're within 60s of expiring (or already expired). If a refresh fails (e.g., the user revoked from `/account`), the bridge exits with a helpful error.\n\n## Build from source\n\n```bash\ngit clone https://github.com/DerpBicycle/gil-mcp-bridge\ncd gil-mcp-bridge\nnpm install\nnpm run build\nnode dist/index.js\n```\n\n## Files\n\n- `src/index.ts` — CLI entry, command dispatch\n- `src/bridge.ts` — stdio ↔ HTTP forwarding\n- `src/login.ts` — OAuth interactive flow (DCR + PKCE + loopback)\n- `src/credentials.ts` — `~/.gil/credentials.json` read/write/refresh\n\n## License\n\nMIT\n",
  "bytes": 3820,
  "sha": "a5c7d0545da7083109584e318a979de48ad4252497f537db8a0a9f3d602a95d8",
  "repo_slug": "derpbicycle/gil-mcp-bridge",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_gameindustrylibrary_gil_1e8c80ba/readme"
}