framework-mcp

Servidor MCP remoto que ofrece a los agentes de codificación (Claude Code, Cursor, etc.) respuestas verificadas y fijadas a una versión sobre frameworks que cambian rápidamente, empezando por Expo SDK 54.

Por qué: los datos de entrenamiento de los LLM quedan obsoletos más rápido que los ciclos de lanzamiento de los frameworks. Los agentes siguen adivinando las mismas preguntas específicas de versión en lugar de consultar una fuente verificada y fijada a una versión. Este servidor es esa fuente.

Stack

Node 24 + TypeScript, @modelcontextprotocol/sdk sobre transporte Streamable HTTP (con estado, sesión por conexión), Express, Postgres (pg), autenticación por clave API mediante el middleware requireBearerAuth del propio SDK.

Alojamiento: Railway (cómputo, plan Hobby de ~$5/mes) + Neon (Postgres, plan gratuito, con ramas).

Configuración local

1. Crea una cuenta y un proyecto gratuitos en Neon. Copia la cadena de conexión de una rama dev.

2. cp .env.example .env y rellena DATABASE_URL (de Neon) y API_KEY_PEPPER (cualquier cadena aleatoria larga; genera una con node -e "console.log(require('crypto').randomBytes(32).toString('hex'))").

3. Instala, migra, siembra y compila:

   npm install
   npm run db:migrate
   npm run db:seed
   npm run build

4. Crea tu propia clave API:

   npm run create-api-key -- "my laptop"

   Esto imprime la clave en bruto una sola vez: guárdala, no se puede recuperar.

5. Ejecuta en local:

   npm run dev

   curl http://localhost:3000/health debería devolver ok.

Verifica con MCP Inspector

npx @modelcontextprotocol/inspector

Conéctate a http://localhost:3000/mcp con el transporte "Streamable HTTP" y establece una cabecera Authorization: Bearer <your-api-key> en la configuración de conexión. Confirma que las 3 herramientas (ping, query_framework_doc, report_outcome) aparecen y se pueden invocar.

Despliegue en Railway

1. curl -fsSL agents.railway.com | sh y luego railway login.

2. Desde este repositorio: railway init (o railway link si ya existe un proyecto).

3. Establece las variables de entorno (panel de control, o railway variable set KEY=value): DATABASE_URL (la cadena de conexión de tu rama production de Neon, separada de tu rama dev), API_KEY_PEPPER, NODE_ENV=production.

4. railway up.

5. En el panel de Railway: Settings → Networking → Generate Domain. Establece PUBLIC_HOSTNAME a ese dominio (necesario para que la comprobación de host por reenlace de DNS del SDK permita tráfico real).

6. Ejecuta npm run db:migrate && npm run db:seed una vez contra la DATABASE_URL de producción (desde tu máquina, apuntando a la cadena de conexión de producción).

7. Crea una clave API de producción con npm run create-api-key, apuntando a la DATABASE_URL de producción.

Obtener una clave API

Autoservicio: visita https://framework-mcp-production.up.railway.app/, introduce un correo electrónico y obtén una clave al instante (una clave activa por correo, con límite de uso).

Alternativa para mantenedores/local: npm run create-api-key -- "label".

Conectar un cliente remoto

En un .mcp.json de Claude Code:

{
  "mcpServers": {
    "framework-mcp": {
      "type": "http",
      "url": "https://<your-railway-domain>/mcp",
      "headers": { "Authorization": "Bearer <your-api-key>" }
    }
  }
}

Herramientas

• ping(message) - comprobación de estado

• query_framework_doc(framework, version, question) - busca una respuesta verificada, devuelve query_id

• report_outcome(query_id, worked, note?) - registra si la respuesta devuelta funcionó realmente

Estado

Datos de ejemplo en db/seed/expo-54.json (20 entradas) verificados contra https://expo.dev/changelog/sdk-54 y https://docs.expo.dev/modules/autolinking/ el 2026-08-21.

El registro de autoservicio está activo en / (correo → clave API instantánea, una por correo, con límite por IP). Listado en Smithery / Glama / mcp.so.

Diferido (Etapa B, aún no construido): facturación con Stripe, plan_tier / credit_balance / aplicación de límite de uso por clave en api_keys, otros frameworks, puntuación/clasificación de los comentarios.