railguey-mcp-cloudflare

Railguey en la nube. Un servidor MCP de Cloudflare Worker que conecta Grok con Railway GraphQL.

La CLI vive en eidos-agi/railguey. Este repositorio es el MCP Streamable HTTP alojado que Grok puede añadir realmente como conector — el MCP propio de Railway (mcp.railway.com) tiene forma de OAuth/CLI y no se puede añadir directamente a Grok.

Worker activo: railguey.eidos-agi.workers.dev

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

Página del producto: eidosagi.com/tools/railguey

Por qué un repositorio separado

El script del Worker todavía se llama railguey en Cloudflare. Ese nombre es el host workers.dev y debe coincidir con name en wrangler.toml. El repositorio de GitHub lleva el nombre de lo que es.

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

Emparejamiento (códigos de canje)

Los tokens de Railway nunca pasan por el chat de Grok. El emparejamiento es un flujo de código de dispositivo:

1. Grok llama a account_pair_begin (o aquí se emite un código).

2. Abre /pair/<CODE> en este worker.

3. Pega un token de Railway y asigna a la cuenta un slug (eidos, personal, client-acme).

4. El worker valida el token contra Railway, lo almacena en KV y Grok lo ve mediante account_list.

Los códigos caducan en 10 minutos, son de un solo uso y se queman después de 8 intentos de pegado fallidos.

Se aceptan tokens de cuenta (railway.com/account/tokens), tokens de workspace y tokens de proyecto (Project → Settings → Tokens). Se registra el tipo para que Grok conozca el alcance.

Múltiples cuentas

Cada emparejamiento es una ranura con nombre. Las herramientas de Railway aceptan un slug account opcional. Una ranura es la predeterminada.

Esto coincide con el modelo de la CLI (~/.railguey/accounts.json) — cuentas con nombre, una predeterminada — almacenado en Workers KV en lugar de un directorio personal.

Puntos de conexión

• GET / — página de estado

• GET /health — estado JSON (sin secretos; incluye metadatos de cuentas emparejadas)

• GET /pair — introduce un código de canje

• GET|POST /pair/:code — pega un token de Railway

• POST /mcp — MCP Streamable HTTP (autenticación requerida)

Secretos y enlaces

• MCP_AUTH_TOKEN — token bearer que Grok envía como Authorization: Bearer …

• KV ACCOUNTS (railguey-accounts) — tokens de Railway emparejados, códigos de canje, slug predeterminado

Nunca hagas commit de tokens. wrangler.toml solo tiene el id del espacio de nombres KV y el id de cuenta de Cloudflare.

Conectar en Grok

1. grok.com/connectors → Añadir conector → Otro

2. URL del servidor: https://railguey.eidos-agi.workers.dev/mcp

3. Encabezado: Authorization: Bearer <MCP_AUTH_TOKEN>

4. Pide a Grok que empareje una cuenta de Railway y luego abre la URL de canje que devuelva.

Despliegue

git push a main es el despliegue. Este repositorio está permanentemente vinculado al Worker activo:

1. Haz push a eidos-agi/railguey-mcp-cloudflare main (especialmente index.js).

2. La automatización de Grok railguey-git-deploy se dispara con ese push, sube index.js al Worker railguey y mantiene KV + MCP_AUTH_TOKEN.

3. Una copia de seguridad horaria redespliega main si se pierde un evento de push.

No hay ningún token de API de Cloudflare en GitHub. No hay ninguna Cloudflare GitHub App. Cambiar el comportamiento del MCP implica editar index.js y hacer push.

loader.js es un Dynamic Worker Loader (git-pull en el borde). No está activo — esta cuenta de Cloudflare está en el plan gratuito de Workers (API 10195). El main de wrangler.toml sigue siendo index.js.

name = "railguey" no debe cambiar. Renombrar el Worker rompería el host activo y la URL del conector de Grok.

Licencia

MIT