12306 Railway
Integrates with China's 12306 railway system to search train tickets, check schedules, and get real-time availability data across the Chinese railway network.
Integrates with China's 12306 railway system to search train tickets, check schedules, and retrieve route information across the Chinese railway network with real-time availability and pricing data.
What it does
- Search train tickets with real-time availability
- Check train schedules and route information
- Query station codes by city or station name
- Get transfer ticket options
- View detailed train stop information
- Access pricing data for routes
Best for
About 12306 Railway
12306 Railway is a community-built MCP server published by freestylefly that provides AI assistants with tools and capabilities via the Model Context Protocol. 12306 Railway server connects to China’s official system for real-time train ticket search, schedules, and route info ac It is categorized under developer tools, analytics data. This server exposes 8 tools that AI clients can invoke during conversations and coding sessions.
How to install
You can install 12306 Railway in your AI client of choice. Use the install panel on this page to get one-click setup for Cursor, Claude Desktop, VS Code, and other MCP-compatible clients. This server runs locally on your machine via the stdio transport. This server supports remote connections over HTTP, so no local installation is required.
License
12306 Railway is released under the MIT license. This is a permissive open-source license, meaning you can freely use, modify, and distribute the software.
Tools (8)
获取当前日期，以上海时区（Asia/Shanghai, UTC+8）为准，返回格式为 "yyyy-MM-dd"。主要用于解析用户提到的相对日期（如“明天”、“下周三”），提供准确的日期输入。
通过中文城市名查询该城市 **所有** 火车站的名称及其对应的 `station_code`，结果是一个包含多个车站信息的列表。
通过中文城市名查询代表该城市的 `station_code`。此接口主要用于在用户提供**城市名**作为出发地或到达地时，为接口准备 `station_code` 参数。
通过具体的中文车站名查询其 `station_code` 和车站名。此接口主要用于在用户提供**具体车站名**作为出发地或到达地时，为接口准备 `station_code` 参数。
通过车站的 `station_telecode` 查询车站的详细信息，包括名称、拼音、所属城市等。此接口主要用于在已知 `telecode` 的情况下获取更完整的车站数据，或用于特殊查询及调试目的。一般用户对话流程中较少直接触发。
一个基于MCP的12306购票搜索服务器
)
)
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购票信息。
🔥应用
1、在 Cursor 中使用
可以智能选票还能生成途径站点可视化地图！
教程：Cursor + 12306 MCP，实现AI智能选票还能生成精美网站
在yb.html中可直接用浏览器打开
2、用阿里云百炼做智能体
教程：阿里百炼+12306 MCP，打造AI智能选票智能体，超酷的！
我在后天想从西安出发去往郑州，请推荐出合理的车票，并推荐三天后返程的车票，
还能对比各个列车票价，做个图表，更直观了。
同样能让他生成列车停靠站点地图：
还能生成途径站点的旅行攻略。这里我的逻辑是先让他去网上搜，搜不到就调用文生图模型，由 AI 生成图片。
阿里自带的这个生图 MCP 感觉能力还是挺强的。
感觉跟真的也差不多啊，哈哈哈。
说实话，在火车上看着自己坐的这一趟列车途径的城市，看着这些景点，心中难免有一丝丝的冲动。
🚩Features
| 功能描述 | 状态 |
|---|---|
| 查询12306购票信息 | ✅ 已完成 |
| 过滤列车信息 | ✅ 已完成 |
| 过站查询 | ✅ 已完成 |
| 中转查询 | ✅ 已完成 |
| 其余接口，欢迎提feature | 🚧 计划内 |
⚙️Installation
git clone https://github.com/freestylefly/12306-mcp.git
npm i
▶️Quick Start
CLI
npm run build
node ./build/index.js
MCP sever configuration
{
"mcpServers": {
"12306-mcp": {
"command": "npx",
"args": [
"-y",
"12306-mcp"
]
}
}
}
👉️Reference
💭Murmurs
本项目原自12306-MCP ，感谢作者，本项目仅用于学习，欢迎催更。
👉️友情链接
- mcp-server-weread ：🚀基于 Model Context Protocol (MCP) 的12306购票搜索服务器。提供了简单的API接口，允许大模型利用接口搜索12306购票信息。
- 12306-MCP ：🚀一个为微信读书提供MCP（Model Context Protocol）服务的工具，支持将微信读书的书籍、笔记和划线数据提供给支持MCP的大语言模型客户端，如Claude Desktop。
- CodeCanvas ：📚本代码仓库是作者苍何多年从事一线互联网Java开发的学习历程技术汇总，旨在为大家提供一个清晰详细的学习教程，侧重点更倾向编写Java核心内容。💪🏻
- PmHub ：🔥PmHub 是一套基于 SpringCloud & LLM 的微服务智能项目管理系统，这个项目旨在帮助小伙伴们快速掌握微服务/分布式项目的架构设计和开发流程，如果想在校招或者社招中拿到一个满意的 offer，PmHub 将是一个非常 nice 的选择。
star 趋势图
公众号
微信搜 苍何 或扫描下方二维码关注苍何的原创公众号，回复 AI 即可和 5000+ 好友一同探讨AI，一同学习MCP。
开源协议
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
Copyright (c) 2025-2026 12306-MCP
Alternatives
Related Skills
Browse all skillsSearch and deploy services from Railway's template marketplace. Use when user wants to add a service from a template, find templates for a specific use case, or deploy tools like Ghost, Strapi, n8n, Minio, Uptime Kuma, etc. For databases (Postgres, Redis, MySQL, MongoDB), prefer the railway-database skill.
Use when building MCP servers or clients that connect AI systems with external tools and data sources. Invoke for MCP protocol compliance, TypeScript/Python SDKs, resource providers, tool functions.
CCXT cryptocurrency exchange library for TypeScript and JavaScript developers (Node.js and browser). Covers both REST API (standard) and WebSocket API (real-time). Helps install CCXT, connect to exchanges, fetch market data, place orders, stream live tickers/orderbooks, handle authentication, and manage errors. Use when working with crypto exchanges in TypeScript/JavaScript projects, trading bots, arbitrage systems, or portfolio management tools. Includes both REST and WebSocket examples.
.NET/C# backend developer for ASP.NET Core APIs with Entity Framework Core. Builds REST APIs, minimal APIs, gRPC services, authentication with Identity/JWT, authorization, database operations, background services, SignalR real-time features. Activates for: .NET, C#, ASP.NET Core, Entity Framework Core, EF Core, .NET Core, minimal API, Web API, gRPC, authentication .NET, Identity, JWT .NET, authorization, LINQ, async/await C#, background service, IHostedService, SignalR, SQL Server, PostgreSQL .NET, dependency injection, middleware .NET.
Build full-stack applications with Supabase (PostgreSQL, Auth, Storage, Real-time, Edge Functions). Use when implementing authentication, database design with RLS, file storage, real-time features, or serverless functions.
Transform data into compelling narratives using visualization, context, and persuasive structure. Use when presenting analytics to stakeholders, creating data reports, or building executive presentations.