iztro OpenAI MCP для Railway

Удаленный MCP-сервер для инструментов Zi Wei Dou Shu / Tu Vi Dau So, подготовленный для Railway и режима разработчика OpenAI ChatGPT.

Что я обнаружил

• По состоянию на 24.04.2026, @feida/iztro-mcp-server не возвращается реестром npm.

• Активный публичный пакет — @xzkcz/iztro-mcp-server@2.2.1.

• Хронология публикации @xzkcz/iztro-mcp-server в npm:

  • 1.0.3 от 26.07.2025

  • 1.0.4 от 03.10.2025

  • 2.2.1 от 03.12.2025

• Метаданные пакета все еще указывают на https://github.com/xzkcz/iztro-mcp-server.git, но этот репозиторий GitHub возвращал 404 во время проверки 24.04.2026.

• Сам опубликованный пакет небольшой и легкий, но его точка входа начинается с transportType: "stdio", поэтому его нельзя напрямую использовать в качестве публичного удаленного MCP-эндпоинта для OpenAI без обертки.

Related MCP server: 命盘 Mingpan

Зачем нужна эта обертка

• Удаленный MCP OpenAI работает через Streamable HTTP или HTTP/SSE.

• Исходный пакет npm поддерживает только stdio.

• Этот проект воссоздает полезные инструменты астрологии только для чтения и предоставляет их по адресам:

  • GET /

  • GET /health

  • POST /mcp и связанный с ним трафик Streamable HTTP

  • GET /sse

Включенные инструменты

• get_astrolabe

• get_horoscope_decades

• get_horoscope_ages

• get_horoscope_years

• get_horoscope_months

• get_mutaged_places

gen_astrolabe был намеренно исключен, так как он записывает файлы на диск и не полезен для публичного MCP-развертывания только для чтения.

Проверка совместимости с Surface Pro 4

• С точки зрения ресурсов, эта рабочая нагрузка достаточно легкая для Surface Pro 4 с процессором Core m3, 4 ГБ ОЗУ и 128 ГБ памяти.

• Размеры опубликованных пакетов, проверенные в npm:

  • @xzkcz/iztro-mcp-server: 67 010 байт в распакованном виде

  • iztro: 2 138 358 байт в распакованном виде

  • fastmcp: 1 332 900 байт в распакованном виде

  • lunar-typescript: 1 360 545 байт в распакованном виде

• Практическая проблема: чтобы ChatGPT мог вызывать его, вам нужен публичный HTTPS-эндпоинт. Поскольку на этой машине не был установлен Node, а для локального хостинга все равно потребовался бы туннель или публичный вход, Railway является более чистым целевым объектом для развертывания.

Развертывание на Railway

1. Поместите эту папку в репозиторий Git.

2. Отправьте его на GitHub.

3. В Railway создайте новый проект из этого репозитория.

4. Railway должен автоматически обнаружить Node и запустить npm start.

5. После развертывания ваш MCP-эндпоинт будет:

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

Проверка работоспособности:

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

Целевая страница:

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

Подключение из ChatGPT

Как подтверждено в документации OpenAI от 24.04.2026:

• Режим разработчика ChatGPT поддерживает удаленный MCP через SSE и streaming HTTP.

• Поддерживаемые режимы аутентификации: OAuth, No Authentication и Mixed Authentication.

Рекомендуемая настройка:

1. Откройте ChatGPT в браузере.

2. Перейдите в Settings -> Apps -> Advanced settings -> Developer mode.

3. Включите режим разработчика.

4. Нажмите Create app.

5. Используйте:

   • URL сервера: https://YOUR-APP.up.railway.app/mcp

   • Аутентификация: No Authentication

Пример API ответов 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"
    }
  ]
}

Поскольку каждый предоставленный здесь инструмент работает только для чтения, require_approval: "never" является разумным значением по умолчанию.

Запуск локально позже, если хотите

npm install
npm start

Локальные эндпоинты:

• http://localhost:3000/mcp

• http://localhost:3000/sse

• http://localhost:3000/health

Если вы хотите, чтобы ChatGPT из публичного Интернета вызывал локальную машину, вам все равно потребуется публичный HTTPS-туннель, такой как Cloudflare Tunnel или другой уровень входящего трафика.

Локальный хостинг для Windows в один клик

Этот репозиторий теперь включает вспомогательные скрипты для Windows:

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

Эта команда:

• запускает MCP-сервер на локальном порту 3000

• сначала пытается создать публичный HTTPS-туннель с помощью Cloudflare Quick Tunnel

• переключается на localhost.run, если Cloudflare недоступен

• выводит публичный URL MCP, который можно вставить в ChatGPT

При использовании локального публичного туннеля подключайте ChatGPT к URL /mcp, а не /sse. Этот проект предназначен для использования через Streamable HTTP для клиентов OpenAI MCP.

Чтобы остановить все:

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

Текущий активный публичный URL MCP также записывается в:

.\.runtime\public-url.txt

Если в окне запуска URL не отображается четко, вы можете восстановить его с помощью:

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

Создание чистого zip-архива для Railway

Чтобы создать чистый пакет развертывания без node_modules или журналов выполнения:

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

Это создает:

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