{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_ssvds79wwp4k","handle":"iflow-mcp-mcp-server-12306","url":"https://wellknown.network/agents/iflow-mcp-mcp-server-12306","links":{"self":"https://wellknown.network/agents/iflow-mcp-mcp-server-12306/record.json","html":"https://wellknown.network/agents/iflow-mcp-mcp-server-12306","markdown":"https://wellknown.network/agents/iflow-mcp-mcp-server-12306/record.md","api":"https://wellknown.network/api/v1/agents/iflow-mcp-mcp-server-12306","status":"https://wellknown.network/api/v1/agents/iflow-mcp-mcp-server-12306/status","claim":"https://wellknown.network/agents/iflow-mcp-mcp-server-12306/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/iflow-mcp-mcp-server-12306/claim.json","badge":"https://wellknown.network/agents/iflow-mcp-mcp-server-12306/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/iflow-mcp-mcp-server-12306/history","tools":"https://wellknown.network/api/v1/agents/iflow-mcp-mcp-server-12306/tools"},"ard":{"identifier":"urn:air::server:iflow-mcp-mcp-server-12306","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"iflow-mcp_mcp-server-12306","summary":"MCP服务器用于12306车票查询","description":"# 🚄 12306 MCP Server\n\n![screenshot](https://img.shields.io/badge/12306-MCP-blue?logo=railway) ![FastAPI](https://img.shields.io/badge/FastAPI-async-green?logo=fastapi) ![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)\n\n---\n\n## ✨ 项目简介\n\n12306 MCP Server 是一款基于 Model Context Protocol (MCP) 的高性能火车票查询后端，支持官方 12306 余票、车站、经停、换乘查询以及智能时间工具，适配 AI/自动化/智能助手等场景。界面友好，易于集成，开箱即用。\n\n---\n\n## 🚀 功能亮点\n\n- 实时余票/车次/座席/时刻/换乘一站式查询\n- 全国车站信息管理与模糊搜索\n- 官方经停站、一次中转方案全支持\n- 智能时间工具，支持相对日期计算，避免日期输入错误\n- Streamable HTTP传输协议，支持MCP 2025-03-26标准\n- FastAPI异步高性能，秒级响应\n- MCP标准，AI/自动化场景即插即用\n\n---\n\n## 🛠️ 快速上手\n\n### 环境要求\n- Python 3.10+\n- [uv](https://astral.sh/uv/)（推荐包管理器）\n\n### 本地一键部署\n```bash\n# 克隆项目\ngit clone https://github.com/drfccv/mcp-server-12306.git\ncd mcp-server-12306\n\n# 安装依赖\nuv sync\n\n# 更新车站信息（必须先执行）\nuv run python scripts/update_stations.py\n\n# 启动服务器\nuv run python scripts/start_server.py\n```\n\n### Docker 部署\n```bash\n# 直接拉取已构建镜像\n docker pull drfccv/mcp-server-12306:latest\n\n# 运行容器（映射8000端口）\n docker run -d -p 8000:8000 --name mcp-server-12306 drfccv/mcp-server-12306:latest\n```\n\n> 如需自定义开发或本地修改后再打包，可用如下命令自行构建镜像：\n> ```bash\n> docker build -t drfccv/mcp-server-12306:latest .\n> ```\n\n### 配置\n复制 `.env.example` 为 `.env` 并按需修改：\n```bash\ncp .env.example .env\n```\n\n---\n\n## 🤖 API & 工具一览\n\n### MCP 客户端配置示例\n```json\n{\n  \"mcpServers\": {\n    \"12306\": {\n      \"url\": \"http://localhost:8000/mcp\"\n    }\n  }\n}\n```\n\n### 支持的主流程工具\n| 工具名                    | 典型场景/功能描述                 |\n|--------------------------|----------------------------------|\n| query_tickets            | 余票/车次/座席/时刻一站式查询     |\n| search_stations          | 车站模糊搜索，支持中文/拼音/简拼   |\n| get_station_info         | 获取车站详情（名称、代码、地理等） |\n| query_transfer           | 一次中转换乘方案，自动拼接最优中转 |\n| get_train_route_stations | 查询指定列车经停站及时刻表         |\n| get_current_time         | 获取当前时间与相对日期，帮助用户准确选择出行日期 |\n\n---\n\n## 📚 工具文档\n\n本项目所有主流程工具的详细功能、实现与使用方法，均已收录于 [`/docs`](./docs) 目录下：\n\n- [query_tickets.md](./docs/query_tickets.md) — 余票/车次/座席/时刻一站式查询\n- [search_stations.md](./docs/search_sta…","publisher":null,"homepage":null,"repository":null,"version":"0.1.0","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:iflow-mcp_mcp-server-12306","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"provenance":"derived"}],"categories":["dev"],"language":"fr"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"iflow-mcp_mcp-server-12306","registry":"pypi","observedAt":"2026-09-15T19:23:10.073Z","publishedAt":"2025-11-28T02:05:14.336881Z","latestVersion":"0.1.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"iflow-mcp_mcp-server-12306","url":"https://pypi.org/project/iflow-mcp_mcp-server-12306/","firstSeenAt":"2026-09-09T20:23:39.736Z","fetchedAt":"2026-09-15T19:21:15.084Z","normalizedAt":"2026-09-15T19:21:15.084Z"}]},"firstSeenAt":"2026-09-09T20:23:39.736Z","updatedAt":"2026-09-15T19:23:10.073Z"}