iztro OpenAI MCP für Railway

Remote-MCP-Server für Zi Wei Dou Shu / Tu Vi Dau So-Tools, vorbereitet für Railway und den OpenAI ChatGPT-Entwicklermodus.

Was ich herausgefunden habe

• Stand 24.04.2026 wird @feida/iztro-mcp-server nicht vom npm-Registry zurückgegeben.

• Das aktive öffentliche Paket ist @xzkcz/iztro-mcp-server@2.2.1.

• npm-Veröffentlichungs-Timeline für @xzkcz/iztro-mcp-server:

  • 1.0.3 am 26.07.2025

  • 1.0.4 am 03.10.2025

  • 2.2.1 am 03.12.2025

• Die Paket-Metadaten verweisen immer noch auf https://github.com/xzkcz/iztro-mcp-server.git, aber dieses GitHub-Repository gab bei der Überprüfung am 24.04.2026 einen 404-Fehler zurück.

• Das veröffentlichte Paket selbst ist klein und leichtgewichtig, aber sein Einstiegspunkt beginnt mit transportType: "stdio", daher ist es ohne Wrapper nicht direkt als öffentlicher Remote-MCP-Endpunkt für OpenAI verwendbar.

Related MCP server: AstroStellar MCP Server

Warum dieser Wrapper existiert

• OpenAI Remote-MCP funktioniert über Streamable HTTP oder HTTP/SSE.

• Das Upstream-npm-Paket ist nur für stdio ausgelegt.

• Dieses Projekt erstellt die nützlichen schreibgeschützten Astrologie-Tools neu und stellt sie bereit unter:

  • GET /

  • GET /health

  • POST /mcp und zugehöriger Streamable HTTP-Datenverkehr

  • GET /sse

Enthaltene Tools

• get_astrolabe

• get_horoscope_decades

• get_horoscope_ages

• get_horoscope_years

• get_horoscope_months

• get_mutaged_places

gen_astrolabe wurde absichtlich weggelassen, da es Dateien auf die Festplatte schreibt und für ein öffentliches, schreibgeschütztes MCP-Deployment nicht nützlich ist.

Eignungsprüfung für Surface Pro 4

• Ressourcenmäßig ist diese Arbeitslast leicht genug für ein Surface Pro 4 mit Core m3, 4 GB RAM und 128 GB Speicher.

• Veröffentlichte Paketgrößen von npm geprüft:

  • @xzkcz/iztro-mcp-server: 67.010 Bytes entpackt

  • iztro: 2.138.358 Bytes entpackt

  • fastmcp: 1.332.900 Bytes entpackt

  • lunar-typescript: 1.360.545 Bytes entpackt

• Praktisches Problem: Damit ChatGPT es aufrufen kann, benötigen Sie einen öffentlichen HTTPS-Endpunkt. Da dieser Computer noch kein Node installiert hatte und lokales Hosting immer noch einen Tunnel oder einen öffentlichen Ingress benötigen würde, ist Railway das sauberere Deployment-Ziel.

Deployment auf Railway

1. Legen Sie diesen Ordner in ein Git-Repository.

2. Pushen Sie es auf GitHub.

3. Erstellen Sie in Railway ein neues Projekt aus diesem Repository.

4. Railway sollte Node automatisch erkennen und npm start ausführen.

5. Nach dem Deployment lautet Ihr MCP-Endpunkt:

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

Gesundheitsprüfung:

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

Landing Page:

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

Verbindung von ChatGPT herstellen

Wie am 24.04.2026 in der OpenAI-Dokumentation verifiziert:

• Der ChatGPT-Entwicklermodus unterstützt Remote-MCP über SSE und streaming HTTP.

• Unterstützte Authentifizierungsmodi sind dort OAuth, No Authentication und Mixed Authentication.

Empfohlene Einrichtung:

1. Öffnen Sie ChatGPT im Web.

2. Gehen Sie zu Settings -> Apps -> Advanced settings -> Developer mode.

3. Schalten Sie den Entwicklermodus ein.

4. Klicken Sie auf Create app.

5. Verwenden Sie:

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

   • Authentifizierung: No Authentication

Beispiel für die OpenAI Responses API

{
  "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"
    }
  ]
}

Da jedes hier bereitgestellte Tool schreibgeschützt ist, ist require_approval: "never" eine vernünftige Standardeinstellung.

Später lokal ausführen, falls gewünscht

npm install
npm start

Lokale Endpunkte:

• http://localhost:3000/mcp

• http://localhost:3000/sse

• http://localhost:3000/health

Wenn Sie möchten, dass ChatGPT im öffentlichen Internet einen lokalen Computer aufruft, benötigen Sie weiterhin einen öffentlichen HTTPS-Tunnel wie Cloudflare Tunnel oder eine andere Ingress-Schicht.

Windows One-Click lokales Hosting

Dieses Repository enthält jetzt Hilfsskripte für Windows:

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

Dieser Befehl:

• startet den MCP-Server auf dem lokalen Port 3000

• versucht zuerst einen öffentlichen HTTPS-Tunnel mit Cloudflare Quick Tunnel

• greift auf localhost.run zurück, falls Cloudflare nicht verfügbar ist

• druckt die öffentliche MCP-URL, die Sie in ChatGPT einfügen können

Wenn Sie den lokalen öffentlichen Tunnel verwenden, verbinden Sie ChatGPT mit der /mcp-URL, nicht mit /sse. Dieses Projekt ist für die Verwendung über Streamable HTTP für OpenAI MCP-Clients vorgesehen.

Um alles zu stoppen:

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

Die aktuell aktive öffentliche MCP-URL wird auch geschrieben nach:

.\.runtime\public-url.txt

Wenn das Startfenster die URL nicht deutlich anzeigt, können Sie sie wiederherstellen mit:

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

Ein sauberes Railway-Zip erstellen

Um ein sauberes Deployment-Paket ohne node_modules oder Laufzeit-Logs zu generieren:

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

Das erstellt:

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