drfccv/mcp-server-12306
12306 MCP Server 是一个基于 Model Context Protocol (MCP) 的高性能火车票查询后端系统。它通过标准化接口提供官方 12306 的实时数据服务,包括余票查询、车站信息、列车经停站、中转换乘方案等核心功能。
Overview
drfccv/mcp-server-12306 is a Python MCP server licensed under MIT. 12306 MCP Server 是一个基于 Model Context Protocol (MCP) 的高性能火车票查询后端系统。它通过标准化接口提供官方 12306 的实时数据服务,包括余票查询、车站信息、列车经停站、中转换乘方案等核心功能。 Topics: 12306, mcp-server.
Ranked #196 out of 25632 indexed tools.
In the top 1% of all indexed tools.
Ecosystem
Python MIT
12306mcp-server
Signal Breakdown
Stars 292
Freshness 1mo ago
Issue Health 100%
Contributors 2
Dependents 0
Forks 46
Description Good
License MIT
How to Improve
Description low impact
Freshness high impact
Dependents medium impact
Matched Queries
From the README
# 🚄 MCP Server 12306
---
## ✨ 项目简介
MCP Server 12306是一款基于 Model Context Protocol (MCP) 的高性能火车票查询后端,支持官方 12306 余票、票价、车站、经停、换乘查询以及智能时间工具,适配 AI/自动化/智能助手等场景。界面友好,易于集成,开箱即用。
---
## 🚀 功能亮点
- 实时余票/车次/座席/时刻/换乘一站式查询
- 全国车站信息管理与模糊搜索
- 官方经停站、一次中转方案全支持
- 实时查询各车次票价信息
- 智能时间工具,支持时区和时间戳
- Streamable HTTP/STDIO传输协议,支持MCP 2025-03-26标准
- FastAPI异步高性能,秒级响应
- MCP标准,AI/自动化场景即插即用
---
## 🛠️ 快速上手
本项目支持两种运行模式:
1. **Stdio 模式**:适用于 Claude Desktop 等本地 MCP 客户端(推荐)。
2. **Streamable HTTP 模式**:适用于远程部署或通过 SSE/Post 访问。
---
### 模式 1:Stdio 模式(Claude Desktop 推荐)
在此模式下,MCP Server 通过标准输入/输出与客户端通信,无需占用网络端口。
#### 方式 A:使用 uvx(推荐)
`uvx` 是 `uv` 包管理器提供的工具,环境隔离且启动极快。
```json
{
"mcpServers": {
"12306": {
"command": "uvx",
"args": ["mcp-server-12306"]
}
}
}
```
#### 方式 B:使用 pipx
如果您更习惯使用 pipx:
```json
{
"mcpServers": {
"12306": {
"command": "pipx",
"args": ["run", "--no-cache", "mcp-server-12306"]
}
}
}
```
#### 方式 C:本地源码运行
适用于开发者调试:
```json
{
"mcpServers" Read full README on GitHub →
Are you the maintainer? Claim this listing