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 访问。

---

在此模式下，MCP Server 通过标准输入/输出与客户端通信，无需占用网络端口。

uvx 是 uv 包管理器提供的工具，环境隔离且启动极快。

{
  "mcpServers": {
    "12306": {
      "command": "uvx",
      "args": ["mcp-server-12306"]
    }
  }
}

如果您更习惯使用 pipx：

{
  "mcpServers": {
    "12306": {
      "command": "pipx",
      "args": ["run", "--no-cache", "mcp-server-12306"]
    }
  }
}

适用于开发者调试：

{
  "mcpServers": {
    "12306": {
      "command": "uv",
      "args": ["run", "python", "-m", "mcp_12306.cli"],
      "cwd": "/path/to/mcp-server-12306"
    }
  }
}

---

在此模式下，Server 启动一个 Web 服务（默认 8000 端口），支持 MCP 的 SSE（Server-Sent Events）和 POST 交互。

# 1. 克隆并安装依赖
git clone https://github.com/drfccv/mcp-server-12306.git
cd mcp-server-12306
uv sync

# 2. 启动服务器
uv run python scripts/start_server.py

MCP 客户端配置：

{
  "mcpServers": {
    "12306": {
      "url": "http://localhost:8000/mcp"
    }
  }
}

# 拉取镜像并运行
docker run -d -p 8000:8000 --name mcp-server-12306 drfccv/mcp-server-12306:latest

---

| 工具名 | 典型场景/功能描述 | |---------