iztro OpenAI MCP para Railway

Servidor MCP remoto para herramientas de Zi Wei Dou Shu / Tu Vi Dau So, preparado para Railway y el modo desarrollador de OpenAI ChatGPT.

Lo que encontré

• A fecha de 24-04-2026, @feida/iztro-mcp-server no aparece en el registro de npm.

• El paquete público activo es @xzkcz/iztro-mcp-server@2.2.1.

• Cronología de publicación en npm para @xzkcz/iztro-mcp-server:

  • 1.0.3 el 26-07-2025

  • 1.0.4 el 03-10-2025

  • 2.2.1 el 03-12-2025

• Los metadatos del paquete aún apuntan a https://github.com/xzkcz/iztro-mcp-server.git, pero ese repositorio de GitHub devolvió un 404 durante la verificación el 24-04-2026.

• El paquete publicado en sí es pequeño y ligero, pero su punto de entrada comienza con transportType: "stdio", por lo que no es utilizable directamente como un endpoint MCP remoto público para OpenAI sin un envoltorio (wrapper).

Related MCP server: 命盘 Mingpan

Por qué existe este envoltorio

• El MCP remoto de OpenAI funciona sobre HTTP transmitible (Streamable) o HTTP/SSE.

• El paquete npm original es solo stdio.

• Este proyecto recrea las herramientas de astrología de solo lectura útiles y las expone en:

  • GET /

  • GET /health

  • POST /mcp y el tráfico HTTP transmitible relacionado

  • GET /sse

Herramientas incluidas

• get_astrolabe

• get_horoscope_decades

• get_horoscope_ages

• get_horoscope_years

• get_horoscope_months

• get_mutaged_places

gen_astrolabe se omitió intencionalmente porque escribe archivos en el disco y no es útil para un despliegue MCP público de solo lectura.

Comprobación de compatibilidad con Surface Pro 4

• En cuanto a recursos, esta carga de trabajo es lo suficientemente ligera para una Surface Pro 4 con Core m3, 4 GB de RAM y 128 GB de almacenamiento.

• Tamaños de paquetes publicados verificados desde npm:

  • @xzkcz/iztro-mcp-server: 67.010 bytes descomprimido

  • iztro: 2.138.358 bytes descomprimido

  • fastmcp: 1.332.900 bytes descomprimido

  • lunar-typescript: 1.360.545 bytes descomprimido

• Problema práctico: para permitir que ChatGPT lo llame, necesitas un endpoint HTTPS público. Debido a que esta máquina no tenía Node instalado y el alojamiento local aún necesitaría un túnel o ingreso público, Railway es el destino de despliegue más limpio.

Desplegar en Railway

1. Coloca esta carpeta en un repositorio Git.

2. Súbelo a GitHub.

3. En Railway, crea un nuevo proyecto desde ese repositorio.

4. Railway debería detectar automáticamente Node y ejecutar npm start.

5. Después del despliegue, tu endpoint MCP será:

https://YOUR-APP.up.railway.app/mcp

Comprobación de estado (health check):

https://YOUR-APP.up.railway.app/health

Página de inicio:

https://YOUR-APP.up.railway.app/

Conectar desde ChatGPT

Como se verificó en la documentación de OpenAI el 24-04-2026:

• El modo desarrollador de ChatGPT admite MCP remoto sobre SSE y HTTP en streaming.

• Los modos de autenticación admitidos son OAuth, Sin autenticación y Autenticación mixta.

Configuración recomendada:

1. Abre ChatGPT en la web.

2. Ve a Settings -> Apps -> Advanced settings -> Developer mode.

3. Activa el modo desarrollador.

4. Haz clic en Create app.

5. Usa:

   • URL del servidor: https://YOUR-APP.up.railway.app/mcp

   • Autenticación: No Authentication

Ejemplo de API de respuestas de OpenAI

{
  "model": "gpt-5.4",
  "input": "Lap la so cho ngay 2000-08-16 luc 2 gio sang, nam, locale zh-CN",
  "tools": [
    {
      "type": "mcp",
      "server_label": "iztro",
      "server_url": "https://YOUR-APP.up.railway.app/mcp",
      "require_approval": "never"
    }
  ]
}

Debido a que cada herramienta expuesta aquí es de solo lectura, require_approval: "never" es un valor predeterminado razonable.

Ejecutar localmente más tarde si lo deseas

npm install
npm start

Endpoints locales:

• http://localhost:3000/mcp

• http://localhost:3000/sse

• http://localhost:3000/health

Si deseas que ChatGPT en la Internet pública llame a una máquina local, aún necesitas un túnel HTTPS público como Cloudflare Tunnel u otra capa de ingreso.

Alojamiento local en Windows con un clic

Este repositorio ahora incluye scripts auxiliares para Windows:

powershell -ExecutionPolicy Bypass -File .\start-local-public.ps1

Ese comando:

• inicia el servidor MCP en el puerto local 3000

• intenta primero un túnel HTTPS público con Cloudflare Quick Tunnel

• recurre a localhost.run si Cloudflare no está disponible

• imprime la URL pública de MCP que puedes pegar en ChatGPT

Al usar el túnel público local, conecta ChatGPT a la URL /mcp, no a /sse. Este proyecto está destinado a ser utilizado sobre HTTP transmitible para clientes MCP de OpenAI.

Para detener todo:

powershell -ExecutionPolicy Bypass -File .\stop-local-public.ps1

La URL pública de MCP activa actualmente también se escribe en:

.\.runtime\public-url.txt

Si la ventana de inicio no muestra la URL claramente, puedes recuperarla con:

powershell -ExecutionPolicy Bypass -File .\get-public-url.ps1

Crear un archivo zip limpio para Railway

Para generar un paquete de despliegue limpio sin node_modules ni registros de tiempo de ejecución:

powershell -ExecutionPolicy Bypass -File .\pack-railway.ps1

Eso crea:

..\iztro-openai-mcp-railway-ready.zip