Joooook/12306-mcp
12306 기차표 검색을 AI 모델에 연결하는 MCP 서버 공개
원제 Joooook/12306-mcp
스타 2,287당일 +320JavaScript
Key Point
AI 어시스턴트가 실제 예약 서비스와 연결되어 기능하는 실용적인 MCP 구현 사례로, 대모형의 외부 도구 연동 방식을 보여준다.
핵심 요약
- 중국의 12306 철도 예약 시스템과 연동하는 Model Context Protocol(MCP) 기반 서버로, 대규모 언어모델이 기차표 검색 정보를 활용할 수 있도록 제공한다.
- 기차표 검색, 열차 정보 필터링, 경유역 조회, 환승 검색 기능을 완성했으며 추가 인터페이스는 로드맵에 포함되어 있다.
- CLI-stdio 모드로는 `npx -y 12306-mcp` 명령으로, CLI-http 모드로는 포트를 지정하여 실행할 수 있다.
- Node.js 18 이상이 필요하며, MCP Inspector 2.0.0을 사용하려면 Node.js 22.19.0 이상이 필요하다.
- Docker를 통해 stdio 또는 http 방식으로 배포할 수 있으며, JSON 설정으로 MCP 서버에 등록하여 사용 가능하다.
- 서비스 원리와 아키텍처 문서를 제공하며, 프로젝트는 학습 목적으로 개발되었다.
저장소 보기 ↗github.com