train-mcp-server

train-mcp-server

Enables querying train and high-speed rail schedules, durations, and seat availability between Chinese stations using 12306 data, with automatic fallback to simulated data when the API is rate-limited.

Category
Visit Server

README

火车票查询 MCP Server（FastMCP）

用 FastMCP 实现的火车票/高铁车次查询服务，可作为远程 MCP 工具被任意 Agent（如 deepagents、LangGraph、Claude 等）调用。

能力

一个工具函数：query_train_tickets(from_station, to_station, date)

  • 查询两个车站之间某天的车次、时刻、历时、可预订状态、余票情况
  • 数据源：12306 公开查询接口（真实数据）；接口被风控时自动切换到模拟数据并明确标注来源，保证链路随时可演示

本地运行

pip install -r requirements.txt
python server.py        # 启动 streamable-http 服务，默认 http://127.0.0.1:8000

MCP 客户端配置（本地联调）：

{
  "mcpServers": {
    "train": {
      "url": "http://127.0.0.1:8000/mcp/",
      "transport": "streamable_http"
    }
  }
}

部署到魔搭 MCP 广场（关键步骤）

  1. 把本仓库推到 GitHub
  2. 打开 modelscope.cn/mcp 登录 → 点 「创建 MCP」
  3. 创建类型选 「GitHub 快速创建」；托管类型选 「可托管部署」
  4. 填英文/中文名称、来源地址（GitHub 仓库 URL），按平台提示补全配置
  5. 提交后平台生成访问地址：https://mcp.api-inference.modelscope.net/<你的ID>/sse 或 /mcp（可设置长期有效）
  6. 把该地址填回 Agent 项目的 MCP 配置中即可

提示：平台对托管项目有启动方式要求（通常要求 Python + 启动 HTTP 服务），如遇部署失败，按平台提示调整入口（如提供 run 脚本或环境变量）。

数据源说明

  • 12306 无官方开放 API，本项目使用其公开查询接口（kyfw.12306.cn/otn/leftTicket），免登录查询，仅限个人学习研究
  • 接口有风控（偶发 302），代码已做会话 cookie + 模拟数据兜底
  • 若需更稳定数据，可自行替换 _fetch_12306 为第三方数据源（可插拔）

目录

  • server.py — FastMCP 服务主程序
  • test_client.py — 本地联调脚本（直接调用工具函数 + 走 MCP 协议测试）
  • requirements.txt — 依赖

Recommended Servers

playwright-mcp

playwright-mcp

A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.

Official
Featured
TypeScript
Magic Component Platform (MCP)

Magic Component Platform (MCP)

An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.

Official
Featured
Local
TypeScript
Audiense Insights MCP Server

Audiense Insights MCP Server

Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.

Official
Featured
Local
TypeScript
VeyraX MCP

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official
Featured
Local
graphlit-mcp-server

graphlit-mcp-server

The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.

Official
Featured
TypeScript
Kagi MCP Server

Kagi MCP Server

An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.

Official
Featured
Python
E2B

E2B

Using MCP to run code via e2b.

Official
Featured
Neon Database

Neon Database

MCP server for interacting with Neon Management API and databases

Official
Featured
Exa Search

Exa Search

A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.

Official
Featured
Qdrant Server

Qdrant Server

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Official
Featured