# 12306-mcp 中文文档

规范地址：https://npmcn.com/package/12306-mcp/

版本：0\.3\.10
npm 元数据更新时间：2026-07-30T14:24:39.251Z
中文译文更新时间：2026-11-05T20:09:00.073Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/12306-mcp
原文对照：https://npmcn.com/package/12306-mcp/?lang=original

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：56.2 kB，5 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：8 个
- 首次发布：2025-04-15T03:48:29.704Z
- 最新版本发布：2026-07-30T14:24:37.839Z
- 近 30 天下载量：31545（2026-10-04 至 2026-11-02，npm 官方下载统计）
- 已发布版本数：18（近 12 个月 3 个）

## 中文简介

这是基于"模式上下文协议"(MCP)的12306购票服务器.

## 安装

```sh
npm install 12306-mcp
```

也可以使用：`pnpm add 12306-mcp`、`yarn add 12306-mcp`、`bun add 12306-mcp`

## README

# 

12306-mcp (中文(简体) )

[![](https://img.shields.io/badge/Joooook-blue.svg?logo=github&lable=python&labelColor=497568&color=497568&style=flat-square)](https://github.com/Joooook) [![](https://img.shields.io/badge/Joooook-blue.svg?logo=bilibili&logoColor=white&lable=python&labelColor=af7a82&color=af7a82&style=flat-square)](https://space.bilibili.com/3546386788255839) ![](https://img.shields.io/badge/typescript-blue.svg?logo=typescript&lable=typescript&logoColor=white&labelColor=192c3b&color=192c3b&style=flat-square) ![](https://img.shields.io/github/stars/Joooook/12306-mcp?logo=reverbnation&lable=python&logoColor=white&labelColor=ffc773&color=ffc773&style=flat-square) ![](https://img.shields.io/github/last-commit/Joooook/12306-mcp.svg?style=flat-square) ![](https://img.shields.io/github/license/Joooook/12306-mcp.svg?style=flat-square&color=000000)

基于"模式上下文协议"(MCP)的12306购票服务器. 服务器提供了一个简单的API接口,允许用户搜索12306门票.

• 示范背景协议(MCP)。

**技能 - > [https://github.com/Joooook/12306-skill\* (中文(简体) )](https://github.com/Joooook/12306-skill*)\* 联合国**

## 

主题

| 功能描述 | 页:1 |
| --- | --- |
| 查询12306购票信息 | 已完成 |
| 过滤列车信息 | 已完成 |
| 过站查询 | 已完成 |
| 中转查询 | 已完成 |
| \====================================================================================================== (=================================== | 🚧 |

![](https://s2.loli.net/2025/04/15/UjbrG5esaSEmJxN.jpg)

![](https://s2.loli.net/2025/04/15/rm1j8zX7sqiyafP.jpg)

## 

安装

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

## 

快速启动

### CLI - stidio (英语)

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

### CLI - http 语言

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

### MCP 断开配置

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

```

### Docker - stidio 函数

```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
```

## 

文档

-   [服务原理详解](https://npmcn.com/package/12306-mcp/docs/principle.md) 12306-MCP服务的工作原理
-   [架构图](https://npmcn.com/package/12306-mcp/docs/architecture.md) 12306-MCP服务的架构图 ![12306-MCP 服务架构图](https://npmcn.com/package/12306-mcp/docs/architecture.png)

## 

参考

-   [模型文本protocol/模型文本protocol](https://github.com/modelcontextprotocol/modelcontextprotocol)
-   [模型文本protocol/类型script-sdk](https://github.com/modelcontextprotocol/typescript-sdk)

## 

穆穆尔

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

## 

贝奇斯

[![12306-mcp MCP server](https://glama.ai/mcp/servers/@Joooook/12306-mcp/badge)](https://glama.ai/mcp/servers/@Joooook/12306-mcp)

[![MseeP.ai Security Assessment Badge](https://mseep.net/pr/joooook-12306-mcp-badge.png)](https://mseep.ai/app/joooook-12306-mcp)

## 

捐款

请我喝杯奶茶吧。

[![](https://s2.loli.net/2024/11/29/1JBxzphs7V6WcK9.jpg)](https://afdian.com/item/2a0e0cdcadf911ef9f725254001e7c00)

## 常见问题

### 12306-mcp 是什么？

这是基于"模式上下文协议"\(MCP\)的12306购票服务器\.

### 如何安装 12306-mcp？

在项目目录运行 npm install 12306-mcp，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 12306-mcp，可以用 npx 12306-mcp 直接运行。

### 12306-mcp 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/12306-mcp 是否存在。

### 12306-mcp 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### 12306-mcp 可以商用吗？

12306-mcp 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### 12306-mcp 的下载量有多少？

根据 npm 官方下载统计，12306-mcp 在 2026/10/04 – 2026/11/02 这 30 天内被下载 31,545 次，日均约 1,052 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### 12306-mcp 还在维护吗？

最新版本 0\.3\.10 发布于 2026/07/30（3 个月前）；至今共发布 18 个版本，其中过去 12 个月发布了 3 个；首次发布于 2025/04/15。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。