Railway용 iztro OpenAI MCP

Railway 및 OpenAI ChatGPT 개발자 모드를 위해 준비된 자미두수(Zi Wei Dou Shu) 도구용 원격 MCP 서버입니다.

발견한 점

• 2026년 4월 24일 기준, @feida/iztro-mcp-server는 npm 레지스트리에서 반환되지 않습니다.

• 현재 활성화된 공개 패키지는 @xzkcz/iztro-mcp-server@2.2.1입니다.

• @xzkcz/iztro-mcp-server의 npm 게시 타임라인:

  • 1.0.3 (2025년 7월 26일)

  • 1.0.4 (2025년 10월 3일)

  • 2.2.1 (2025년 12월 3일)

• 패키지 메타데이터는 여전히 https://github.com/xzkcz/iztro-mcp-server.git을 가리키고 있으나, 2026년 4월 24일 확인 결과 해당 GitHub 저장소는 404 오류를 반환했습니다.

• 게시된 패키지 자체는 작고 가볍지만, 진입점이 transportType: "stdio"로 시작하므로 래퍼(wrapper) 없이는 OpenAI를 위한 공개 원격 MCP 엔드포인트로 직접 사용할 수 없습니다.

Related MCP server: 命盘 Mingpan

이 래퍼가 존재하는 이유

• OpenAI 원격 MCP는 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 적합성 확인

• 리소스 측면에서 이 작업 부하는 Core m3, 4GB RAM, 128GB 스토리지를 갖춘 Surface Pro 4에서 실행하기에 충분히 가볍습니다.

• 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에서 연결하기

2026년 4월 24일 OpenAI 문서에서 확인된 내용:

• ChatGPT 개발자 모드는 SSE 및 streaming HTTP를 통한 원격 MCP를 지원합니다.

• 지원되는 인증 모드는 OAuth, 인증 없음, 혼합 인증입니다.

권장 설정:

1. 웹에서 ChatGPT를 엽니다.

2. 설정 -> 앱 -> 고급 설정 -> 개발자 모드로 이동합니다.

3. 개발자 모드를 켭니다.

4. 앱 만들기를 클릭합니다.

5. 다음을 사용합니다:

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

   • 인증: 인증 없음

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

여기서 노출되는 모든 도구는 읽기 전용이므로 require_approval: "never"가 합리적인 기본값입니다.

원한다면 나중에 로컬에서 실행하기

npm install
npm start

로컬 엔드포인트:

• http://localhost:3000/mcp

• http://localhost:3000/sse

• http://localhost:3000/health

공개 인터넷의 ChatGPT가 로컬 기기를 호출하게 하려면 Cloudflare Tunnel이나 다른 인그레스 계층과 같은 공개 HTTPS 터널이 여전히 필요합니다.

Windows 원클릭 로컬 호스팅

이 저장소에는 이제 Windows용 도우미 스크립트가 포함되어 있습니다:

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

해당 명령어는:

• 로컬 포트 3000에서 MCP 서버를 시작합니다.

• 먼저 Cloudflare Quick Tunnel을 사용하여 공개 HTTPS 터널을 시도합니다.

• Cloudflare를 사용할 수 없는 경우 localhost.run으로 대체합니다.

• ChatGPT에 붙여넣을 수 있는 공개 MCP URL을 출력합니다.

로컬 공개 터널을 사용할 때는 ChatGPT를 /sse가 아닌 /mcp URL에 연결하세요. 이 프로젝트는 OpenAI MCP 클라이언트를 위해 Streamable HTTP를 통해 사용하도록 의도되었습니다.

모든 것을 중지하려면:

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

현재 활성화된 공개 MCP URL은 다음에도 기록됩니다:

.\.runtime\public-url.txt

시작 창에 URL이 명확하게 표시되지 않으면 다음으로 복구할 수 있습니다:

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

깔끔한 Railway zip 만들기

node_modules나 런타임 로그 없이 깔끔한 배포 번들을 생성하려면:

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

다음이 생성됩니다:

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