Railway MCP Server

Railway MCP Server

Permite que Claude y otros clientes MCP gestionen tu infraestructura de Railway.app. Despliega servicios, gestiona variables y monitorea despliegues, todo mediante lenguaje natural.

Un servidor de Model Context Protocol (MCP) para integrarse con la plataforma Railway.app.

Tabla de Contenidos

Características • Instalación • Herramientas Disponibles • Ejemplos de Flujos de Trabajo • Seguridad • Solución de Problemas • Contribuciones

Características

• ✅ Autenticación con tokens de API de Railway
• ✅ Gestión de proyectos (listar, información, eliminar)
• ✅ Gestión de despliegues (listar, reiniciar)
• ✅ Gestión de servicios (crear desde repositorio de GitHub o imagen Docker, listar)
• ✅ Gestión de variables (listar, crear/actualizar, eliminar)
• ✅ Gestión de red de servicios
• ✅ Gestión de volúmenes
• ❌ Soporte completo para todas las plantillas
  • 🚧🔨⏳ Soporte de plantillas de bases de datos
  • Flujos de trabajo automáticos de bases de datos y redes
• 🚧🔨⏳ Los flujos de trabajo más utilizados
• ❌ Vinculación automática de repositorios de GitHub para servicios

Instalación

Requisitos previos

• Node.js 18+ (para soporte de la API fetch integrada)
• Una cuenta activa de Railway
• Un token de API de Railway (crea uno en https://railway.app/account/tokens)

Inicio rápido

Este servidor MCP está diseñado para funcionar con clientes MCP como:

• Claude for Desktop | ✅ Probado en batalla
• Cursor | ✅ Necesita pruebas
• Cline | 🚧🔨⏳ Necesita pruebas
• Windsurf | 🚧🔨⏳ Necesita pruebas
• Otros clientes MCP | 🚧🔨⏳ Necesita pruebas

Instalación mediante Smithery

Para instalar railway-mcp automáticamente, recomendamos usar Smithery

Claude Desktop

npx -y @smithery/cli install @jason-tan-swe/railway-mcp --client claude

Cursor

npx -y @smithery/cli@latest run @jason-tan-swe/railway-mcp --config "{\"railwayApiToken\":\"token\"}"

npx -y @jasontanswe/railway-mcp <RAILWAY_API_TOKEN>

   "railway": {
      "command": "npx",
      "args": ["-y", "@jasontanswe/railway-mcp"],
      "env": {
         "RAILWAY_API_TOKEN": "your-railway-api-token-here"
      }
   }

{
  "mcpServers": {
    // ... All of your existing MCP servers ...

    // Add the railway-mcp server to your configuration with your API token
    "railway": {
      "command": "npx",
      "args": ["-y", "@jasontanswe/railway-mcp"],
      "env": {
        "RAILWAY_API_TOKEN": "your-railway-api-token-here"
      }
    }
  }
}

Please list all my Railway projects

Please configure the Railway API with my token: {YOUR_API_TOKEN_HERE}

Recomendaciones y otra información

Este servidor se combina mejor con clientes MCP que tengan acceso a terminal o con Git (Cursor, Windsurf). Se recomienda usar este MCP con otros, ya que railway-mcp orquesta contenedores y agiliza tu proceso de despliegue sin problemas.

Servidores MCP recomendados para combinar

• Git || Enlace oficial
• GitHub || Oficial || Smithery

Para Claude

• De fábrica, Claude no tiene acceso a terminal, por lo que no puede activar despliegues ya que no podrá obtener el último commit.
• Levantar diferentes servicios y monitorearlos es el mejor caso de uso con Claude.

Para Cursor

• Usa con GitHub MCP o ten el repositorio ya configurado en GitHub y clonado localmente en tu máquina para aprovechar la integración completa con railway-mcp.
• Cuando Cursor hace un cambio, puede olvidar enviar sus cambios a GitHub, lo que provoca que intente desplegar un commit que Railway no puede extraer.
  • SOLUCIÓN: Siempre pregunta o incluye en algún lugar de tu prompt: Have you pushed our changes to GitHub yet?

Consideraciones de seguridad

• Los tokens de API de Railway proporcionan acceso completo a tu cuenta. Mantenlos seguros.
• Cuando se usa el método de variable de entorno, tu token se almacena en el archivo de configuración de Claude Desktop.
• Los valores de variables sensibles se enmascaran automáticamente al mostrarse.
• Todas las llamadas a la API usan HTTPS para una comunicación segura.
• El almacenamiento de tokens solo en memoria del servidor significa que tu token nunca se escribe en disco fuera del archivo de configuración.

Solución de problemas

Si encuentras problemas:

1. Problemas de autenticación de token

   • Asegúrate de que tu token de API sea válido y tenga los permisos necesarios
   • Si usas el método de variable de entorno, verifica que el token esté correctamente formateado en el archivo de configuración
   • Intenta usar la herramienta configure directamente en Claude si el token de entorno no funciona

2. Problemas de conexión del servidor

   • Verifica que hayas instalado la última versión del servidor
   • Verifica que esté instalada la versión 18 o superior de Node.js
   • Reinicia Claude for Desktop después de hacer cambios en la configuración

3. Errores de API

   • Verifica que estés usando los IDs correctos de proyecto, entorno y servicio
   • Revisa la página de estado de Railway para ver si hay interrupciones del servicio
   • La API de Railway tiene límites de velocidad: evita hacer demasiadas solicitudes en un período corto

Contribuciones

¡Damos la bienvenida a contribuciones de la comunidad! Consulta nuestras Guías de contribución para obtener detalles sobre cómo comenzar, pautas de desarrollo e información de depuración.

Herramientas disponibles