railguey-mcp-cloudflare

Railguey в облаке. MCP-сервер на Cloudflare Worker, который соединяет Grok с Railway GraphQL.

CLI находится в eidos-agi/railguey. Этот репозиторий — размещённый Streamable HTTP MCP, который Grok действительно может добавить как коннектор: собственный MCP Railway (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 по-прежнему называется railguey на Cloudflare. Это имя является хостом workers.dev и должно совпадать с name в wrangler.toml. Репозиторий GitHub назван по своему назначению.

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

Привязка (claim-коды)

Токены Railway никогда не передаются через чат Grok. Привязка — это поток device-code:

1. Grok вызывает account_pair_begin (или код создаётся здесь).

2. Вы открываете /pair/<CODE> на этом Worker.

3. Вставьте токен Railway и присвойте аккаунту slug (eidos, personal, client-acme).

4. Worker проверяет токен через Railway, сохраняет его в KV, и Grok видит его через account_list.

Коды действуют 10 минут, одноразовые и сгорают после 8 неудачных вставок.

Принимаются токены аккаунта (railway.com/account/tokens), токены рабочего пространства и токены проекта (Проект → Настройки → Токены). Тип записывается, чтобы Grok знал область действия.

Несколько аккаунтов

Каждая привязка — это именованный слот. Инструменты Railway принимают опциональный slug account. Один слот — по умолчанию.

Это соответствует модели CLI (~/.railguey/accounts.json) — именованные аккаунты, один по умолчанию, — но вместо домашней директории данные хранятся в Workers KV.

Эндпоинты

• GET / — страница статуса

• GET /health — JSON-статус (без секретов; включает метаданные привязанных аккаунтов)

• GET /pair — ввод claim-кода

• GET|POST /pair/:code — вставка токена Railway

• POST /mcp — MCP Streamable HTTP (требуется авторизация)

Секреты и привязки

• MCP_AUTH_TOKEN — bearer-токен, который Grok отправляет как Authorization: Bearer …

• KV ACCOUNTS (railguey-accounts) — привязанные токены Railway, claim-коды, slug по умолчанию

Никогда не коммитьте токены. wrangler.toml содержит только id пространства имён KV и id аккаунта Cloudflare.

Подключение в Grok

1. grok.com/connectors → Добавить коннектор → Другое

2. URL сервера: https://railguey.eidos-agi.workers.dev/mcp

3. Заголовок: Authorization: Bearer <MCP_AUTH_TOKEN>

4. Попросите Grok привязать аккаунт Railway, затем откройте claim-URL, который он вернёт.

Деплой

git push в main — это деплой. Этот репозиторий навсегда привязан к живому Worker:

1. Пушите в eidos-agi/railguey-mcp-cloudflare main (особенно index.js).

2. Автоматизация Grok railguey-git-deploy срабатывает на этот push, загружает index.js в Worker railguey и сохраняет KV + MCP_AUTH_TOKEN.

3. Ежечасный резервный деплой переразворачивает main, если событие push было пропущено.

В GitHub нет API-токена Cloudflare. Нет Cloudflare GitHub App. Изменение поведения MCP означает правку index.js и push.

loader.js — это Dynamic Worker Loader (git-pull на границе сети). Он не в продакшене — этот аккаунт Cloudflare находится на бесплатном тарифе Workers (API 10195). В wrangler.toml main остаётся index.js.

name = "railguey" нельзя менять. Переименование Worker сломает живой хост и URL коннектора Grok.

Лицензия

MIT