Back to packageRELEASE DETAILS

0.3.0

npm

12306-mcp

This is a 12306 ticket search server based on the Model Context Protocol (MCP).

Published18 May 2025

Direct dependencies7

Transitive dependenciesNot calculated

README

Current package documentation

12306-mcp

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

如需Skill -> https://github.com/Joooook/12306-skill

🚩Features

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

⚙️Installation

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

▶️Quick Start

CLI-stdio

npx -y 12306-mcp

CLI-http

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

MCP sever configuration

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

Docker-stdio

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

Docker-http

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

📚Documentation

服务原理详解 12306-MCP服务的工作原理
架构图 12306-MCP服务的架构图

👉️Reference

💭Murmurs

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

🎫Badges

☕️Donate

请我喝杯奶茶吧。

Downloads & popularity

Awaiting observations

No metric observations yet

Download counts and popularity will appear here as the collector receives them.

Declared dependencies 7

Native requirements

7 direct targetsNot calculated transitive count

Package / target	Requirement	Relationship
zod Environment { "local_name": "zod", "alias": false, "peer_metadata": null }	`^3.24.2`	runtime
axios Environment { "local_name": "axios", "alias": false, "peer_metadata": null }	`^1.8.4`	runtime
date-fns Environment { "local_name": "date-fns", "alias": false, "peer_metadata": null }	`^4.1.0`	runtime
date-fns-tz Environment { "local_name": "date-fns-tz", "alias": false, "peer_metadata": null }	`^3.2.0`	runtime
@modelcontextprotocol/sdk Environment { "local_name": "@modelcontextprotocol/sdk", "alias": false, "peer_metadata": null }	`^1.9.0`	runtime
typescript Environment { "local_name": "typescript", "alias": false, "peer_metadata": null }	`^5.8.3`	development
@types/node Environment { "local_name": "@types/node", "alias": false, "peer_metadata": null }	`^22.14.1`	development

Distribution files

1 collected

Distribution 1

Source distribution

Source file

Checksums from source

{
  "shasum": "dc37225a4aa8b971499600ef480a2ee0f509c9c5",
  "tarball": "https://registry.npmjs.org/12306-mcp/-/12306-mcp-0.3.0.tgz",
  "fileCount": 5,
  "integrity": "sha512-fH2/PjuefZhF/DPdoLYemwnkT/gORV8uBYuZ+twdcBB6VWcY+7WlJjf7v94illuFmXL8oU+fqDp7Z30xz9uhLw==",
  "signatures": [
    {
      "sig": "MEYCIQCGoSdHUN1KV/OBK8N1Rprw1zivYgROUxmWhGvImJu7UwIhAOqD6whx8iNY+n5SrKnsuPUHOEQLax2Yzpk4frzNHT+U",
      "keyid": "SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"
    }
  ],
  "unpackedSize": 38907
}

Metadata history

Meaningful changes

Current collected state Current

Observed since 20 Oct, 18:08 UTC

No superseded metadata states collected. Unchanged observations do not create new revisions.

Record identity

package_version:d1c237542ecf1289c96b07546babae07698b13ee5dfd90e5b4a512cc640b0788

Other collected versions

0.3.1030 Jul 0.3.929 Jun 0.3.88 Mar 0.3.710 Oct 0.3.67 Oct 0.3.522 Aug View all collected versions →