# 12306 Ticket Search Server

Provide a simple API interface to search and filter 12306 train tickets, including direct, transfer, and stopover queries. Enable large language models to access real-time 12306 ticket information ef…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add DeniseLewis200081/rail

# Browse available tools
npx -y @smithery/cli@latest tool list DeniseLewis200081/rail

# Get full schema for a tool
npx -y @smithery/cli@latest tool get DeniseLewis200081/rail get-current-date

# Call a tool
npx -y @smithery/cli@latest tool call DeniseLewis200081/rail get-current-date '{}'
```

## Direct MCP Connection

Endpoint: `https://rail--deniselewis200081.run.tools`

## Tools (8)

- `get-current-date` — 获取当前日期，以上海时区（Asia/Shanghai, UTC+8）为准，返回格式为 "yyyy-MM-dd"。主要用于解析用户提到的相对日期（如“明天”、“下周三”），为其他需要日期的接口提供准确的日期输入。
- `get-stations-code-in-city` — 通过中文城市名查询该城市 **所有** 火车站的名称及其对应的 `station_code`，结果是一个包含多个车站信息的列表。
- `get-station-code-of-citys` — 通过中文城市名查询代表该城市的 `station_code`。此接口主要用于在用户提供**城市名**作为出发地或到达地时，为接口准备 `station_code` 参数。
- `get-station-code-by-names` — 通过具体的中文车站名查询其 `station_code` 和车站名。此接口主要用于在用户提供**具体车站名**作为出发地或到达地时，为接口准备 `station_code` 参数。
- `get-station-by-telecode` — 通过车站的 `station_telecode` 查询车站的详细信息，包括名称、拼音、所属城市等。此接口主要用于在已知 `telecode` 的情况下获取更完整的车站数据，或用于特殊查询及调试目的。一般用户对话流程中较少直接触发。
- `get-tickets` — 查询12306余票信息。
- `get-interline-tickets` — 查询12306中转余票信息。尚且只支持查询前十条。
- `get-train-route-stations` — 查询特定列车车次在指定区间内的途径车站、到站时间、出发时间及停留时间等详细经停信息。当用户询问某趟具体列车的经停站时使用此接口。

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get DeniseLewis200081/rail <tool-name>
```

---

Source: https://github.com/DeniseLewis200081/12306-mcp | License: MIT