12306-mcp logo

12306-mcp

Community
Joooook

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

PublisherJoooook
Repository12306-mcp
LanguageJavaScript
Forks
154
Stars
891
Available tools
8
Transport typestdio
Categories
Other
LicenseMIT
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

    891 stars and 154 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购票信息。

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

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

👉️Reference

💭Murmurs

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

🎫Badges

MseeP.ai Security Assessment Badge

☕️Donate

请我喝杯奶茶吧。

Installation

TypingMind
Prerequisites:

Node.js 18+

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

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.

1

Open the MCP settings

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

  1. Open TypingMind in your browser.
  2. Click the Settings icon.
  3. Go to Advanced Settings.
  4. Open the Model Context Protocol section.
  5. Click Setup Connector and choose This Device.
TypingMind MCP connector setup screen with This Device selected
2

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.

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

Add 12306-mcp as a server

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

  1. Wait until the connector status shows Ready.
  2. Click Edit Servers.
  3. Paste the 12306-mcp MCP server configuration.
  4. Save the server list.
  5. Refresh if you want to confirm the connector is still ready.
TypingMind MCP settings showing active server and Edit Servers button
{
  "mcpServers": {
    "joooook-12306-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "12306-mcp"
      ]
    }
  }
}
4

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.

  1. Open the Plugins page in TypingMind.
  2. Enable the 12306-mcp MCP tools.
  3. Start a chat and choose the AI model you want to use.
  4. Use the MCP tools in chat or assign them to an AI agent.
  5. Switch to another AI model whenever needed without reconnecting MCP.
TypingMind chat using enabled MCP tools with a selected AI model
Can you use 12306-mcp to help me with this task?
12306-mcp
Sure. I read it.
Here is what I found using 12306-mcp.

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.

Related MCP Servers

View all
Coding-Solo logo

Godot MCP

Coding-Solo
CommunityPopular

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

363
3.6K
0 tools
View details
punitarani logo

Fli - 航班搜索 MCP 服务器与库

punitarani
CommunityPopular

Google Flights MCP, CLI and Python Library

293
2.6K
0 tools
View details
ahujasid logo

Ableton Live

ahujasid
CommunityPopular

Enables control of Ableton Live music production software through a bidirectional communication system that supports track creation, MIDI editing, playback control, instrument loading, and library browsing for music composition and sound design workflows.

327
2.5K
16 tools
View details
datadaddy89 logo

Looker MCP

datadaddy89
CommunityPopular

Query Looker data with natural language using Google's Conversational Analytics API. Supports stdio (Claude Desktop) and HTTP (Cloud Run) deployment modes.

0
2.4K
17 tools
View details

Set up your own AI workspace now

Get notified about new features and future giveaways by subscribing to our newsletter 👇