12306-mcp README

The project's README from github.com/Joooook/12306-mcp. As one markdown file: README.md.

12306-mcp

A 12306 ticket search server based on the Model Context Protocol (MCP). The server provides a simple API interface that allows users to search for 12306 tickets.

基于 Model Context Protocol (MCP) 的12306购票搜索服务器。提供了简单的API接口,允许大模型利用接口搜索12306购票信息。

如需Skill -> https://github.com/Joooook/12306-skill

🚩Features

功能描述 状态
查询12306购票信息 ✅ 已完成
过滤列车信息 ✅ 已完成
过站查询 ✅ 已完成
中转查询 ✅ 已完成
其余接口,欢迎提feature 🚧 计划内

⚙️Installation

git clone https://github.com/Joooook/12306-mcp.git
npm i

▶️Quick Start

CLI-stdio

npx -y 12306-mcp

CLI-http

npx -y 12306-mcp --port [端口号]

Runtime requirements

The server requires Node.js 18 or newer. The npm run debug command uses MCP Inspector 2.0.0, which requires Node.js 22.19.0 or newer.

MCP sever configuration

{
    "mcpServers": {
        "12306-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "12306-mcp"
            ]
        }
    }
}

Docker-stdio

docker build . -t 12306-mcp
docker run --rm -it 12306-mcp npx 12306-mcp

Docker-http

docker build . -t 12306-mcp
docker run -p [your_port]:8080 -d 12306-mcp npx 12306-mcp --port 8080

📚Documentation

👉️Reference

💭Murmurs

本项目仅用于学习,欢迎催更。

🎫Badges

12306-mcp MCP server

MseeP.ai Security Assessment Badge

☕️Donate

请我喝杯奶茶吧。

12306-mcp (Joooook/12306-mcp)

Searching Database…

Что это?12306-mcp — это сервер Model Context Protocol (MCP), который позволяет ИИ-моделям искать железнодорожные билеты в китайской системе бронирования 12306 через простой API.
Это отдельное приложение или сервер, который подключается к моему ИИ-ассистенту?Это MCP-сервер: вы запускаете его и подключаете к совместимому с MCP ИИ-клиенту (например, Claude или другому LLM-инструменту), который затем вызывает его API для поиска билетов.
Как его запустить?Можно запустить напрямую через CLI в режиме stdio или HTTP либо использовать готовую конфигурацию Docker (Docker-stdio или Docker-http), а затем указать её в конфиге своего MCP-клиента.
Что нужно установить для запуска?Нужен Node.js 18 или новее; для отладочной команды с MCP Inspector 2.0.0 требуется Node.js 22.19.0 или новее.
Это годится для реальной покупки билетов или только для обучения?Автор пишет, что проект создан только в учебных целях — это не официально одобренный и не гарантированный продакшен-инструмент бронирования.
Кому это пригодится?Разработчикам ИИ-агентов и чат-ботов, которым нужно смотреть расписания китайских поездов и наличие билетов, не листая вручную сайт 12306.
Какие запросы по билетам он поддерживает?Поддерживаются стандартный поиск билетов 12306, фильтрация поездов по критериям, запрос остановок вдоль маршрута и поиск маршрутов с пересадками.
Нужен ли аккаунт 12306 или API-ключ?В README не упоминается необходимость аккаунта 12306 или API-ключа — нужно лишь запустить сервер и подключить MCP-клиент.
Планируются ли новые функции?Да: в README дополнительные интерфейсы помечены как запланированные («计划内»), и пользователей приглашают предлагать новые функции.
Creator
Joooook
Size
0.6 MB
Stars
2.4K
Age
1y
Commits · 90 Days