12306-mcp

CommunityPopular

Joooook

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

Publisher	Joooook
Repository	`12306-mcp`
Language	JavaScript
Forks	277
Stars	1.6K
Available tools	8
Transport type	stdio
Categories	Other
License	MIT
Links	GitHub

Connect tools to AI workflows
12306-mcp exposes MCP capabilities that can be used by compatible AI clients and agents.
8 available tools
Browse the callable actions below, including names and descriptions when provided by the server.
Ready-to-copy setup
Use the installation snippets to configure this server in your preferred MCP client.
Open source signals
1.6K stars and 277 forks from the linked repository.

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

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

▶️Quick Start

CLI-stdio

bash
npx -y 12306-mcp

CLI-http

bash
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

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

Docker-stdio

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

📚Documentation

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

👉️Reference

modelcontextprotocol/modelcontextprotocol
modelcontextprotocol/typescript-sdk

💭Murmurs

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

🎫Badges

☕️Donate

请我喝杯奶茶吧。

Installation

TypingMind

Prerequisites:

Node.js 18+

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

Available Tools

get-current-date
获取当前日期，以上海时区（Asia/Shanghai, UTC+8）为准，返回格式为 "yyyy-MM-dd"。主要用于解析用户提到的相对日期（如“明天”、“下周三”），提供准确的日期输入。
get-stations-code-in-city
通过中文城市名查询该城市所有火车站的名称及其对应的 station_code，结果是一个包含多个车站信息的列表。
get-station-code-of-citys
通过中文城市名查询代表该城市的 station_code。此接口主要用于在用户提供城市名作为出发地或到达地时，为接口准备 station_code 参数。
get-station-code-by-names
通过具体的中文车站名查询其 station_code 和车站名。此接口主要用于在用户提供具体车站名作为出发地或到达地时，为接口准备 station_code 参数。
get-station-by-telecode
通过车站的 station_telecode 查询车站的详细信息，包括名称、拼音、所属城市等。此接口主要用于在已知 telecode 的情况下获取更完整的车站数据，或用于特殊查询及调试目的。一般用户对话流程中较少直接触发。
get-tickets
查询12306余票信息。
get-interline-tickets
查询12306中转余票信息。尚且只支持查询前十条。
get-train-route-stations
查询特定列车车次在指定区间内的途径车站、到站时间、出发时间及停留时间等详细经停信息。当用户询问某趟具体列车的经停站时使用此接口。

Use 12306-mcp MCP with multiple AI models

TypingMind connects MCP tools at the workspace level, so once 12306-mcp is connected, you can use it with different AI models in TypingMind instead of setting it up separately for each model. This MCP runs locally through the TypingMind MCP connector on your device.

Setup guide to use the local connector

Use this when the MCP server needs access to local files, apps, or private resources on your computer.

Open the MCP settings

In TypingMind, go to Settings, Advanced Settings, then Model Context Protocol and choose Setup Connector.

Open TypingMind in your browser.
Click the Settings icon.
Go to Advanced Settings.
Open the Model Context Protocol section.
Click Setup Connector and choose This Device.

TypingMind MCP connector setup screen with This Device selected

Run the connector command

Choose This Device, copy the command from TypingMind, and run it in Terminal. Keep the process running while you use MCP.

Copy the setup command shown by TypingMind.
Open Terminal on macOS or Windows Terminal on Windows.
Paste and run the command.
Approve the package install if Terminal asks you to proceed.
Keep the Terminal window running while using MCP tools.

Add 12306-mcp as a server

When the connector status is Ready, click Edit Servers and paste the MCP server configuration.

Wait until the connector status shows Ready.
Click Edit Servers.
Paste the 12306-mcp MCP server configuration.
Save the server list.
Refresh if you want to confirm the connector is still ready.

TypingMind MCP settings showing active server and Edit Servers button

Use it across models

Save the server list, open Plugins, enable the 12306-mcp MCP tools, then select any supported AI model in TypingMind and use the tools in chat or assign them to an AI agent.

Open the Plugins page in TypingMind.
Enable the 12306-mcp MCP tools.
Start a chat and choose the AI model you want to use.
Use the MCP tools in chat or assign them to an AI agent.
Switch to another AI model whenever needed without reconnecting MCP.

TypingMind chat using enabled MCP tools with a selected AI model

Frequently asked questions

What is the 12306-mcp MCP server used for?

12306-mcp is an MCP server that lets compatible AI clients connect to external tools and context. In TypingMind, you can add this MCP server once and make its tools available in your AI workspace.

Can I use 12306-mcp MCP with multiple AI models in TypingMind?

Yes. TypingMind connects MCP tools at the workspace level, so you can use 12306-mcp with different AI models such as Claude, ChatGPT, Gemini, or other models you have configured in TypingMind without setting up the MCP server separately for each model.

Why use 12306-mcp MCP with TypingMind?

TypingMind is one of the best frontends for LLM chat because it brings multiple AI models, prompts, plugins, AI agents, API keys, and MCP tools into one workspace. With 12306-mcp connected, you can use its MCP tools across your preferred models while keeping your chat workflow organized in TypingMind.

How do I connect 12306-mcp MCP to TypingMind?

12306-mcp runs through the TypingMind local MCP connector. This is best when the MCP server needs access to local files, desktop apps, command-line tools, or private resources on your computer.

What tools does 12306-mcp MCP provide in TypingMind?

12306-mcp exposes 8 MCP tools that can be enabled from the TypingMind Plugins page and used in chat or assigned to AI agents.

Do I need to share my API keys with TypingMind to use 12306-mcp MCP?

No. TypingMind is local-first and lets you keep your model providers, API keys, prompts, and MCP configuration under your control. If 12306-mcp requires authentication, add the required headers, OAuth settings, or local configuration for that MCP server when you create the connection.

stations

Related MCP Servers

View all

codegraph

colbymchenry

CommunityPopular

Pre-indexed code knowledge graph, auto syncs on code changes, for Claude Code, Codex, Gemini, Cursor, OpenCode, AntiGravity, Kiro, CoPilot, and Hermes Agent — fewer tokens, fewer tool calls, 100% local

goose

an open source, extensible AI agent that goes beyond code suggestions - install, execute, edit, and test with any LLM

CyberStrikeAI

The system of action for AI-native cybersecurity—where intent becomes governed execution, evidence becomes operational memory, and every operation improves the next.

Godot MCP

MCP server for interfacing with Godot game engine. Provides tools for launching the editor, running projects, and capturing debug output.

12306-mcp

🚩Features

⚙️Installation

▶️Quick Start

CLI-stdio

CLI-http

Runtime requirements

MCP sever configuration

Docker-stdio

Docker-http

📚Documentation

👉️Reference

💭Murmurs

🎫Badges

☕️Donate

Installation

Available Tools

Use 12306-mcp MCP with multiple AI models

Setup guide to use the local connector

Open the MCP settings

Run the connector command

Add 12306-mcp as a server

Use it across models

Frequently asked questions

Related MCP Servers

Set up your own AI workspace now