Back to packageRELEASE DETAILS

0.2.4

npm

12306-mcp

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

Published7 May 2025

Direct dependencies5

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 5

Native requirements

5 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
@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": "7ce1e0cf2108e8bb1f024ba77d2ae240bc8f037f",
  "tarball": "https://registry.npmjs.org/12306-mcp/-/12306-mcp-0.2.4.tgz",
  "fileCount": 5,
  "integrity": "sha512-uhhPqAxC4/gxlVU4mtKWWcJpc95nfYXK0yhOQJP8g6GRWuE9+gUf3M3lmMeIoaMn7y7IE6Ts7/uK9xroNv+U4Q==",
  "signatures": [
    {
      "sig": "MEUCICj9z+h4cyTgVUldWeK1XrGXErZmwDcPZCgBZoPXNkqxAiEAk/PgJ7u8EbX5/kzq2qEbjroaY79i9rIZF6/OWCocKoE=",
      "keyid": "SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"
    }
  ],
  "unpackedSize": 26274
}

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:1b9d3138cdc7f624cb6ee2324ae129f43a8aaa6b5329cb793e512cdaeef60072

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 →