drfccv/mcp-server-12306
Developer tools이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기
12306 MCP 서버는 모델 컨텍스트 프로토콜(MCP)을 기반으로 한 고성능 열차 티켓 조회 백엔드 시스템입니다. 티켓 가용성 조회, 역 정보, 열차 정차, 환승 솔루션과 같은 핵심 기능을 포함한 표준화된 인터페이스를 통해 공식 12306 실시간 데이터 서비스를 제공합니다.
개요
MCP 서버 12306은 모델 컨텍스트 프로토콜(MCP)을 기반으로 한 고성능 열차 티켓 조회 서비스입니다. 공식 12306 티켓 가용성, 티켓 가격, 역, 정차역, 환승 문의, 지능형 시간 도구를 지원합니다. AI, 자동화, 지능형 어시스턴트 시나리오와 호환되며, 기본 사용 가능합니다. - 남은 티켓/열차 번호/좌석/시간/환승 실시간 원스톱 검색 - 국가 역 정보 관리 및 퍼지 검색, 중국어, 병음, 간체 병음, 3자 코드 지원 - 공식 정차 및 환승 솔루션 완전 지원 - 각 열차별 실시간 요금 정보 - 시간대와 타임스탬프를 지원하는 지능형 시간 도구 - 이중 전송 모드: Stdio (Claude Desktop 권장) | 스트리밍 가능한 HTTP(원격 배포) - MCP 2025-03-26 표준, AI/자동화 시나리오용 플러그 앤 플레이 이 프로젝트는 두 가지 런타임 모드를 지원합니다: 1. : Claude Desktop과 같은 로컬 MCP 클라이언트에 적합함(권장). 2. : 원격 배포 또는 SSE/POST를 통한 접근에 적합함. 이 모드에서 MCP 서버는 네트워크 포트를 차지하지 않고 표준 입출력을 통해 클라이언트와 통신합니다. 이 모드에서 서버는 MCP SSE 및 POST 상호작용을 지원하는 웹 서비스(기본 포트 8000)를 시작합니다. 이 프로젝트의 주요 프로세스 도구의 모든 상세 기능, 구현 및 사용 방법은 /docs 디렉토리에 포함되어 있습니다: 각 문서에는 다음이 포함됩니다: - 도구 설명 - 구현 방법 - 요청 매개변수 및 반환 예시 - 일반적인 호출 패턴 - 이 프로젝트는 학습, 연구 및 기술 교류만을 위한 것이며; 상업적 사용은 엄격히 금지됩니다. - 이 프로젝트는 공식 12306 데이터를 저장, 변경 또는 배포하지 않습니다; 단지 공식 공개 인터페이스의 지능적 집계 및 전달 역할만 합니다. - 이 프로젝트 사용으로 인해 발생하는 모든 결과(계정 차단, 데이터 이상 현상, 법적 위험 등 포함되되 이에 국한되지 않음)는 사용자의 책임이며, 프로젝트 작성자는 어떠한 책임도 지지 않습니다. - 중국 법률 및 규정과 공식 12306 규칙을 준수하시고, 합리적이고 준수하게 사용해 주시기 바랍니다.
개요(AI 번역)
모델 컨텍스트 프로토콜(MCP) 기반 12306 열차표 조회 서비스
여섯 가지 주요 쿼리 기능을 지원합니다: 남은 티켓/요금/역/정류/환승/시간, 기본 사용 가능, AI 어시스턴트, 자동 스크립트, 스마트 단말기 및 기타 시나리오에 적합합니다.
📑 목차
- ✨ 기능적 특성
- 🚀 빨리 시작
- 환경 요구사항
- 방법 1: Stdio 모드 (로컬 클라이언트에 권장)
- 방법 2: 스트리밍 가능한 HTTP 모드 (원격 배포)
- 방법 3: 도커 배포
- 🛠️ 도구 개요
- ⚙️ 구성 항목
- 🏗️ 프로젝트 구조
- 🧑 💻 개발 가이드
- 📚 상세한 문서 작성
- ⚠️ 면책 조항
- 📄 면허
✨ 기능적 특징
| 카테고리 | 능력 |
|---|---|
| 🎫 남은 티켓 문의 | 남은 티켓 / 열차 번호 / 좌석 / 시간을 원스톱 검색, 열차 번호로 필터링 지원 |
| 💰 요금 조회 | 각 열차별 요금과 좌석 유형(비즈니스 클래스 → 비좌석, 전면 커버리지) 실시간 조회 |
| 🏙️ 역 검색 전국 3,382+개 역 지원, 중국어 / 병음 / 간체 병음 / 3자 코드 퍼지 검색 | |
| 🔄 이동 중 환승 | 공식 환승 계획은 자동으로 경로를 페이지 지정하고 기록하여 전체 경로와 대기 시간을 반환합니다 |
| 🛤️ 정차 문의 | 지정된 열차의 모든 정차장 및 도착 및 출발 시간을 확인하세요 |
| 🕐 시간 도구 | 모든 시간대의 현재 시간과 상대 날짜를 검색하여 여행 날짜 선택 |
| 🔌 이중 전송 모드 | Stdio(로컬) | 스트리밍 가능한 HTTP(원격), 동일한 코어 인스턴스를 공유함 |
| 🔄 프로토콜 자동 협상 | MCP SDK v2 기반, 핸드셰이크 시대(2025-11-25)와 현대 프로토콜(2026-07-28)과 자동 호환됨 |
🚀 빨리 시작하세요
환경 요구 사항
| 의존 | 요청 |
|---|---|
| Python | [>= 3.10, 💡 推荐使用 uv’: 환경 격리, 빠른 설치, 파일 관리 의존성 버전. |
방법 1: Stdio 모드 (로컬 클라이언트 권장)
MCP 서버는 표준 입출력을 통해 클라이언트와 통신하며, 네트워크 포트를 차지하지 않고 Claude Desktop과 Cursor와 같은 로컬 MCP 클라이언트에 적합합니다.
설치:
클라이언트 구성 (예: claude_desktop_config.json):
기타 설치 방법 (클릭하여 확장)
pipx:
로컬 소스 코드 (개발자 디버깅):
방법 2: 스트리밍 가능한 HTTP 모드 (원격 배포)
이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.
설치
uvx mcp-server-12306설정
{
"mcpServers": {
"12306": {
"command": "uvx",
"args": ["mcp-server-12306"]
}
}
}