### [12306票务搜索服务](https://s.ddm.chat/link/670)

**Published:** 2026-07-23T02:00:23

**Author:** 颠倒梦

**Excerpt:** 基于Model Context Protocol (MCP)的12306票务搜索服务器，提供API接口查询12…

# 

12306-mcp

[](https://github.com/Joooook)  
[](https://space.bilibili.com/3546386788255839)

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购票信息。

## 

🚩Features

| 功能描述 | 状态  |
| --- | --- |
| 查询12306购票信息 | ✅ 已完成 |
| 过滤列车信息 | ✅ 已完成 |
| 过站查询 | ✅ 已完成 |
| 中转查询 | ✅ 已完成 |
| 其余接口，欢迎提feature | 🚧 计划内 |

## 

⚙️Installation

```bash
git clone https://github.com/Joooook/12306-mcp.git
npm i
```

## 

▶️Quick Start

### CLI-stdio

```bash
npx -y 12306-mcp
```

### CLI-http

```bash
npx -y 12306-mcp --port [端口号]
```

### MCP sever configuration

```json
{
    "mcpServers": {
        "12306-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "12306-mcp"
            ]
        }
    }
}
```

### Docker-stdio

```bash
docker build . -t 12306-mcp
docker run --rm -it 12306-mcp npx 12306-mcp
```

### Docker-http

```bash
docker build . -t 12306-mcp
docker run -p [your_port]:8080 -d 12306-mcp npx 12306-mcp --port 8080
```

## 

📚Documentation

-   [服务原理详解](./docs/principle.md) 12306-MCP服务的工作原理
-   [架构图](./docs/architecture.md) 12306-MCP服务的架构图

## 

👉️Reference

-   [modelcontextprotocol/modelcontextprotocol](https://github.com/modelcontextprotocol/modelcontextprotocol)
-   [modelcontextprotocol/typescript-sdk](https://github.com/modelcontextprotocol/typescript-sdk)

## 

💭Murmurs

本项目仅用于学习，欢迎催更。

## 

🎫Badges

[

](https://glama.ai/mcp/servers/@Joooook/12306-mcp)

[](https://mseep.ai/app/joooook-12306-mcp)

## 

☕️Donate

请我喝杯奶茶吧。

[

](https://afdian.com/item/2a0e0cdcadf911ef9f725254001e7c00)



---