12306 Mcp

Name: 12306 Mcp
Author: Joooook

Local

github.com/JoooookMaps & Travel2.4kUpdated 13w ago

Repository

About 12306 Mcp

12306-mcp is an MCP server for searching 12306 train tickets, letting language models query ticket availability through a simple API. It supports filtering trains, stop-station lookups and transfer searches, and is aimed at developers and AI assistants that need Chinese rail ticket data.

Key features

01Search 12306 ticket availability
02Filter train information by conditions
03Stop-station query
04Transfer route query
05Runs over stdio or HTTP

Use cases

01Letting an AI assistant check tickets for a given date and route
02Filtering trains that match specific criteria
03Looking up intermediate stops and transfer options

MCP support

This project is an MCP server that exposes 12306 ticket search functions to language models and MCP clients.

#mcp #12306 #train-tickets #mcp-server

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config

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

Run commandnpx -y 12306-mcp

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages

npm12306-mcpstdio

Tools

Saved tool list · updated 3w ago

This tool takes no parameters.

Details

From the project README

12306-mcp

README image

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 [端口号]

Runtime requirements

The server requires Node.js 18 or newer. The npm run debug command uses MCP Inspector 2.0.0, which requires Node.js 22.19.0 or newer.

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

请我喝杯奶茶吧。

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

Read the getting-started guide

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.