12306-mcp功能特点
查询12306购票信息：项目的核心功能是实现对12306票务信息的查询，通过与12306官方系统进行数据交互，能够获取实时的车票信息，包括：车次、发车时间、到达时间、座位类型和票价等详细信息。
过滤列车信息：我们用户可以根据自己的出行计划和偏好，如出发地、目的地、日期、车次类型等条件对查询结果进行过滤。
过站查询：过站查询功能，可以帮助我们用户查询经过特定站点的列车信息，这个功能对于需要在中途换乘或者对某个站点有特殊关注的朋友来说非常实用。
中转查询：中转查询功能则针对我们有换乘需求的朋友，它能够根据用户的出发地和目的地，结合各次列车的时刻表，智能推荐中转方案，帮助旅客规划合理的换乘行程。
项目技术架构与原理解析
技术架构
前后端分离架构：12306-mcp项目采用前后端分离的架构设计，前端主要负责与用户进行交互，提供直观的操作界面和展示查询结果；
后端则负责处理业务逻辑、数据处理以及与12306官方系统的数据对接。让我们开发人员对于项目的模块化开发和维护变得非常简单容易，同时也提高了系统的可扩展性。
12306-MCP服务原理服务启动时通过 getStations() 函数从12306API获取全国车站信息，构建四个核心索引：
具体流程：
访问 12306 首页 (https://www.12306.cn/index/)； 从 HTML 中提取车站名称 JS 文件路径； 下载并解析 JS 文件，获取原始车站数据； 补充缺失的车站信息 (MISSING_STATIONS)； 基于车站数据得到四个核心数据结构映射表；
// 1. 车站id -> 车站信息STATIONS: Record<string, StationData> // "AAA": {// "station_id": "@aaa",// "station_name": "北京北",// "station_code": "AAA",// "station_pinyin": "beijingbei",// "station_short": "aaa",// "station_index": "0",// "code": "1234",// "city": "北京",// "r1": "",// "r2": ""// }// 2. 城市名 -> 车站id 和 站名 (可能一个城市多个站)CITY_STATIONS: Record<string, { station_code: string; station_name: string }> // "北京": [{"station_code": "AAA","station_name": "北京北"},{"station_code": "BBB","station_name": "京东"},...]// 3. 车站名(与城市名相同,只会有一个) -> 车站id 和 站名 CITY_CODES: Record<string, { station_code: string; station_name: string }> // "北京":{"station_code":"CCC","station_name":"北京"}// 4. 车站名 -> 车站id 和 站名NAME_STATIONS: Record<string, { station_code: string; station_name: string }> // "北京北":{"station_code":"AAA","station_name":"北京北"}数据流程与工具关系
车票查询流程：
用户查询 "后天北京到上海的高铁" - 大模型调用流程： ↓1. get-current-date() → "2024-01-15" (获取当前日期)2. 大模型理解后天日期 → "2024-01-17"3. get-station-code-of-citys("北京|上海") → {"北京": {"station_code": "BJP","station_name": "北京"}, "上海": {"station_code": "SHH","station_name": "上海"}} ↓4. get-tickets(date: "2024-01-17", fromStation: "BJP", toStation: "SHH", trainFilterFlags: "G") ↓5. 内部数据处理(参数验证, Cookie获取, API调用, 格式化输出文本) ↓6. 返回格式化的高铁车次信息（车次、时间、价格、余票等）中转查询流程：
用户查询 "深圳到拉萨，经过西安中转" ↓1. 获取三个城市的车站id2. get-interline-tickets(from: "SZQ", to: "LSO", transfer: "XAY") ↓3. 内部数据处理(参数验证, Cookie获取, API调用, 格式化输出文本) ↓4. 返回中转方案（第一程 + 第二程）
经停站查询流程：
用户查询 "G1次列车经停哪些站" ↓1. get-train-route-stations(trainNo: "G1", from: "BJP", to: "SHH") ↓2. 数据处理：parseRouteStationsData() → parseRouteStationsInfo() ↓3. 返回经停站列表（站名、到达时间、出发时间、停留时间）
基础tool
get-current-date: 获取上海时区当前日期
返回当前上海时区的时间日期字符串("yyyy-MM-dd") 为其他工具提供准确的查询日期基准 get-stations-code-in-city: 查询城市内所有车站（使用CITY_STATIONS）输入：中文城市名 查找： CITY_STATIONS[city]获取该城市所有车站列表返回：包含 station_code和station_name的数组get-station-code-of-citys: 获取城市代表车站id（使用CITY_CODES）输入：城市名（支持 "|" 分隔的多个城市） 查找： CITY_CODES[city]获取与城市同名的主要车站返回：每个城市对应的代表车站信息 get-station-code-by-names: 车站名转车站id（使用NAME_STATIONS）输入：具体车站名（支持 "|" 分隔的多个车站） 查找： NAME_STATIONS[stationName]精确匹配车站名返回：车站id和车站名 get-station-by-telecode: 车站id查车站信息（使用STATIONS）输入：车站id 查找： STATIONS[telecode]获取完整车站信息返回：包含拼音、城市等详细信息
核心tool (输入可通过基础tool获取)
get-tickets: 查询12306余票信息
输入：出发日期、出发站id、到达站id、车次类型筛选 参数处理：检查日期不早于当前日期，验证车站id存在性, 构造请求入参 Cookie 处理：先获取 12306 Cookie 用于身份验证 API 调用：访问 /otn/leftTicket/query接口数据处理, 车次类型筛选 返回格式化数据 get-interline-tickets: 中转换乘查询，支持指定中转站输入：出发站id、到达站id、中转站id、是否显示无座、车次类型筛选 参数处理：检查日期不早于当前日期，验证车站id存在性, 构造请求入参 Cookie 处理：先获取 12306 Cookie 用于身份验证 API 调用：访问 /lcquery/queryU接口数据处理, 车次类型筛选 返回格式化数据 get-train-route-stations: 列车经停站查询输入：车次编码(可以调用get-tickets获取)、出发站id、到达站id、出发日期 参数处理：检查日期不早于当前日期，验证车站id存在性, 构造请求入参 Cookie 处理：先获取 12306 Cookie 用于身份验证 API 调用：访问 /otn/czxx/queryByTrainNo接口返回格式化数据
12306-mcp安装配置
CLI
npm run buildnode ./build/index.js
MCP sever configuration
{ "mcpServers": { "12306-mcp": { "command": "npx", "args": [ "-y", "12306-mcp" ] } }}
