Back to packageRELEASE DETAILS

0.3.1

npm

12306-mcp

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

Published19 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": "669ba03b9d4d041b14e61b5cb4a8c1961a4895c0",
  "tarball": "https://registry.npmjs.org/12306-mcp/-/12306-mcp-0.3.1.tgz",
  "fileCount": 5,
  "integrity": "sha512-JE+Avz0JlTrpS44OY3lhcfD1rD4igcDfqS+3Pn4pRWwhxrPl9mpP/Itj4m79EqJW3nicMj7bB4qnaEO/nqVpKw==",
  "signatures": [
    {
      "sig": "MEUCIQCGOOFa3V/1ATkqOg2MOnWFYdiGaDHkKbtpyht8Diql7AIgEsdohPalCa8rvOya2wnryVF415KmBzncsDiMa6JuLWg=",
      "keyid": "SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"
    }
  ],
  "unpackedSize": 39015
}

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:dc1eefb893ec0ad7d6e4df66a12e9e6d8acbc482765f7a139f1e00973b09c775

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 →