railguey-mcp-cloudflare

Railguey クラウド版。Grok と Railway GraphQL を橋渡しする Cloudflare Worker MCP サーバー。

CLI は eidos-agi/railguey にあります。このリポジトリは、Grok が実際にコネクタとして追加できるホスト型 Streamable HTTP MCP です。Railway 純正の MCP（mcp.railway.com）は OAuth/CLI 型で、Grok に直接追加できません。

ライブ Worker: railguey.eidos-agi.workers.dev

MCP: https://railguey.eidos-agi.workers.dev/mcp

プロダクトページ: eidosagi.com/tools/railguey

なぜ別リポジトリなのか

Worker スクリプトは Cloudflare 上では引き続き railguey という名前です。この名前は workers.dev のホストであり、wrangler.toml の name と一致する必要があります。GitHub リポジトリは、その内容に応じた名前になっています。

Related MCP server: @crisog/railway-mcp-server

ペアリング（クレームコード）

Railway トークンが Grok チャットを通過することはありません。ペアリングはデバイスコードフローです:

1. Grok が account_pair_begin を呼び出します（またはここでコードが発行されます）。

2. この Worker で /pair/<CODE> を開きます。

3. Railway トークンを貼り付け、アカウントに slug（eidos、personal、client-acme）を付けます。

4. Worker は Railway に対してトークンを検証し、KV に保存します。Grok は account_list でそれを確認できます。

コードは10分で期限切れになり、一度きりの使用で、貼り付けに8回失敗すると破棄されます。

アカウントトークン（railway.com/account/tokens）、ワークスペーストークン、プロジェクトトークン（プロジェクト → 設定 → トークン）はすべて受け付けられます。種別が記録されるため、Grok はスコープを把握できます。

複数アカウント

各ペアは名前付きスロットです。Railway ツールはオプションの account slug を受け取ります。1つのスロットがデフォルトになります。

これは CLI のモデル（~/.railguey/accounts.json）と同じです。名前付きアカウント、デフォルト1つという構成を、ホームディレクトリの代わりに Workers KV に保存します。

エンドポイント

• GET / — ステータスページ

• GET /health — JSON ヘルス（機密情報なし。ペアリング済みアカウントのメタデータを含む）

• GET /pair — クレームコードを入力

• GET|POST /pair/:code — Railway トークンを貼り付け

• POST /mcp — MCP Streamable HTTP（認証必須）

シークレットとバインディング

• MCP_AUTH_TOKEN — Grok が Authorization: Bearer … として送信するベアラートークン

• KV ACCOUNTS（railguey-accounts）— ペアリング済み Railway トークン、クレームコード、デフォルトの slug

トークンをコミットしないでください。wrangler.toml には KV ネームスペース ID と Cloudflare アカウント ID しかありません。

Grok で接続

1. grok.com/connectors → コネクタを追加 → その他

2. サーバー URL: https://railguey.eidos-agi.workers.dev/mcp

3. ヘッダー: Authorization: Bearer <MCP_AUTH_TOKEN>

4. Grok に Railway アカウントのペアリングを依頼し、返されたクレーム URL を開きます。

デプロイ

main への git push がデプロイです。 このリポジトリは恒久的にライブ Worker に接続されています:

1. eidos-agi/railguey-mcp-cloudflare の main にプッシュします（特に index.js）。

2. Grok オートメーション railguey-git-deploy がそのプッシュで発火し、index.js を Worker railguey にアップロードして、KV と MCP_AUTH_TOKEN を維持します。

3. プッシュイベントを取り逃した場合、毎時のバックアップが main を再デプロイします。

GitHub には Cloudflare API トークンはありません。Cloudflare GitHub App もありません。MCP の動作を変更するには index.js を編集してプッシュします。

loader.js は Dynamic Worker Loader（エッジでの git-pull）です。これはライブではありません — この Cloudflare アカウントは無料の Workers プラン（API 10195）にあります。wrangler.toml の main は index.js のままです。

name = "railguey" は変更してはいけません。Worker の名前を変更すると、ライブホストと Grok のコネクタ URL が壊れます。

ライセンス

MIT