MCP 12306.git

基本能力

产品定位

mcp_12306是一个基于MCP协议的12306火车票查询服务端项目，旨在提供高效、便捷的火车票查询服务。

核心功能

• 火车票余票查询：支持指定出发站、到达站、出发日期、乘客类型（成人/学生）等参数，查询12306实时余票信息。
• 车站代码/名称查询：可根据车站中文名查询对应的12306车站代码，或反查车站名称。
• Redis缓存支持：查询结果可自动缓存到Redis，提升高频查询性能。
• MCP工具集成：以工具（tool）的形式对外暴露接口，便于LLM/自动化系统集成。
• 命令行参数灵活：支持自定义服务端口、传输方式（stdio/sse）、是否启用Redis等。

适用场景

• 需要快速查询火车票余票信息的用户。
• 需要获取车站代码或名称的开发者和系统集成者。
• 需要高频查询火车票信息的自动化系统。

工具列表

• query_tickets：查询火车票信息。
• get_station_code：获取车站代码。
• get_station_name：获取车站名称。

使用教程

使用依赖

uv pip install mcp-12306

安装教程

启动Redis（可选）

如需启用Redis缓存，需先启动本地Redis服务（默认端口6379）。

# Linux
redis-server

# Windows（需提前安装Redis for Windows或Memurai）
redis-server.exe

启动服务

python启动

进入mcp_12306目录后，使用以下命令启动服务：

python -m mcp_12306 --redis 6379

uvx启动

不带Redis启动：

uvx mcp-12306

带Redis启动：

uvx mcp-12306 --redis 6379

调试方式

启动服务后，可以通过调用提供的工具（如query_tickets、get_station_code、get_station_name）进行调试。具体命令取决于集成环境。