关于 atlas
atlas 为 MCP 客户端提供知名铁路线路数据,涵盖长途、高速、夜车和风景线路。记录包含线路信息与地理几何数据,可用于探索和可视化铁路行程。
主要功能
- 01线路信息与地理几何数据
- 02知名铁路服务的分类
- 03行程时间、距离和最高速度
- 04CSV、JSON 和 GeoJSON 数据文件
适用场景
- 01查询知名列车线路详情
- 02比较线路长度和行程时间
- 03按类别可视化铁路线路
MCP 相关
MCP 服务在 https://worldtrainmap.com/mcp 将线路图集作为工具提供给 Claude 和其他 MCP 客户端。其数据来自网站图集,比仓库中的数据文件更新。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://trainrouter.com/mcpclaude mcp add --transport http com-trainrouter-atlas https://trainrouter.com/mcp{"mcpServers":{"com-trainrouter-atlas":{"type":"http","url":"https://trainrouter.com/mcp"}}}在 Cursor 中打开{"servers":{"com-trainrouter-atlas":{"type":"http","url":"https://trainrouter.com/mcp"}}}在 VS Code 中打开{"mcpServers":{"com-trainrouter-atlas":{"type":"http","url":"https://trainrouter.com/mcp"}}}{"mcpServers":{"com-trainrouter-atlas":{"serverUrl":"https://trainrouter.com/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
7| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| limit | integer | 否 | 返回路线的最大数量。默认值:10,最大值:50。 |
| query | string | 否 | 与名称、城市、列车、运营商和国家/地区匹配的自由文本,例如 "glacier"、"Tokyo"、"Amtrak"。省略可按知名度浏览所有路线。 |
| country | string | 否 | 仅显示途经此国家/地区的路线;可填写全名或 2 位 ISO 代码("Switzerland" 或 "CH")。 |
| category | enum | 否 | 仅显示此类别中的路线。high-speed | classic | night | scenic | heritage | mountain | luxury |
详细介绍
世界火车地图图集——以开放数据呈现世界传奇铁路线路
961 条铁路线路 · 118 个国家 · 约 432,800 千米线路,每条线路都包含其关键事实和几何数据,数据来自 worldtrainmap.com,这是一个交互式世界铁路地图。
高速干线(Eurostar、TGV、Shinkansen、AVE)、经典长途线路(Trans-Siberian、California Zephyr)、夜班列车(Nightjet、the Ghan),以及人们专程乘飞机前往体验的风景线路(Glacier Express、Bernina Express、the Jacobite)。
🗺️ 交互式探索:worldtrainmap.com
🤖 **通过 AI 助手使用:**免费 MCP 服务,地址为 https://worldtrainmap.com/mcp(连接方法);也可以从此仓库运行:npm install && npm start(mcp/)
**网站已更名。**截至 2026 年 8 月 11 日,网站原名为 TrainRouter,域名为
trainrouter.com,现在更名为 World Train Map,域名为worldtrainmap.com。旧域名会逐路径重定向,因此旧链接仍然有效;而https://trainrouter.com/mcp仍会直接响应而不重定向,因为 JSON-RPC 客户端不会跟随重定向。你之前配置的内容都没有失效。仓库、Zenodo DOI 和 MCP 注册表名称(com.trainrouter/atlas)会有意保留旧标识符:更改它们造成的影响远大于整理它们带来的好处。
各版本分别包含什么
关于此图集,流传着几种不同的线路数量。以下是准确的版本说明。
| 位置 | 线路数 | 截止日期 | 说明 |
|---|---|---|---|
| 在线网站 | 1,338 | 今天 | worldtrainmap.com,始终是最新版本 |
| MCP 服务 | 1,247 | 2026 年 8 月 11 日 | 与网站分开部署,因此会稍有滞后 |
此仓库中的 data/ 以及 Hugging Face | 961 | 2026 年 7 月 23 日 | 克隆或下载此仓库时获取的版本 |
| Zenodo(可引用的 DOI) | 744 | 2026 年 7 月 12 日 | v1.1.0 版本,最后一个已标记的版本 |
**下载版本落后于网站,这是有意为之。**自 7 月下旬以来,线路几何数据一直在逐步根据 OpenStreetMap 铁路关系重新描绘,因此成为 OSM 数据在 ODbL 许可下的衍生作品,而本软件包中的所有内容均采用 CC BY 4.0 许可。在按线路拆分许可之前发布更新,就等于以我们的名义发布违反许可的内容,因此导出器会一直停用,直到相关工作完成。请参阅下文的来源、准确性与出处。如果你想获取比 7 月版本更新的数据,而又不想等待,MCP 服务是目前最接近最新版本的选择。
文件
| 文件 | 内容 |
|---|---|
data/routes.csv | 每条线路一行,包含所有事实,不含几何数据 |
data/routes.json | 相同记录,包含结构化国家对象 |
data/routes.geojson | 每条线路的 LineString(经纬度航点),以及作为属性的所有事实 |
架构
| 字段 | 类型 | 说明 |
|---|---|---|
id | string | 稳定的 slug,例如 glacier-express |
name | string | 线路/服务名称 |
from, to | string | 起终点城市 |
category | enum | 此版本包括:high-speed · classic · night · scenic · luxury。在线图谱还增加了 mountain 和 heritage |
train | string | 车辆,例如 e320 · Class 374 |
operator | string | 运营公司 |
distance_km | number | 线路长度 |
top_speed_kmh | number | 服务最高速度 |
duration | string | 公布的行程时间,例如 2 h 16 min |
opened | number | 线路/服务投入运营的年份 |
pax_per_year | number|null | 有公布数据时的年客运量估值;这种情况很少见:961 条记录中只有 80 条有此数据 |
countries_iso / countries | string | 以 | 分隔,按行程顺序排列(CSV);JSON 中为结构化对象 |
highlight | string | 用一句话描述这条线路闻名的原因 |
fame_rank | number | 1 = 最有名(图谱自身的知名度排名) |
url | string | 线路页面。这些链接在更名之前编写,仍指向 trainrouter.com,该域名会重定向到 worldtrainmap.com 上的同一路径;下一版将更新这些链接 |
快速开始
import pandas as pd
routes = pd.read_csv("data/routes.csv")
routes.nsmallest(10, "fame_rank")[["name", "from", "to", "distance_km"]]
import geopandas as gpd
gdf = gpd.read_file("data/routes.geojson")
gdf.plot(column="category", figsize=(16, 8))
来源、准确性与出处
- 出处信息于 2026 年 7 月下旬发生变化 — 本节已于 2026-07-31 更新以说明此事。 图谱最初完全由人工构建,而事实数据至今仍是如此:内容汇编自公开资料,并非来自任何授权数据集,因此作者有权授予事实数据的 CC BY 4.0 许可。
- 线路几何:最初为人工描绘,现正逐步改用 OSM 描绘。 每条线路的
LineString最初都是沿着线路走廊、按地图比例手动放置[lon, lat]路径点绘制而成。从 2026 年 7 月 23 日起,线路走向已逐步通过 Overpass 从 OpenStreetMap 铁路路径重新描绘,使线条与真实轨道吻合。目前data/中的文件是 7 月 23 日的更新版本:其中几乎所有几何数据仍是人工描绘的类型,但少数线路(Brenner、Oslo–Göteborg、Oslo–Stockholm、Pustertalbahn)已采用 OSM 描绘,这些线条遵循任何 OSM 衍生几何数据的要求,采用 © OpenStreetMap contributors, ODbL。本 README 的早期版本曾称几何数据“并非提取自 OSM 或任何地理数据源”;这在撰写时(v1.0,7 月 12 日)属实,但如今已不再成立,因此我们在此发布说明。下一版将逐条标明不同许可:事实数据采用 CC BY 4.0,几何数据采用 ODbL。此后,在线网站上的重新描绘工作已有很大进展,因此网站上的线路与本软件包中的线路不再是同一组线条。 - 事实数据是近似的公开数值: 距离、最高速度、行程时间、运营商、开通年份和估算客运量均汇编自公开资料(运营商公布的数据、时刻表、新闻材料、百科文章)。此类单项事实不可受版权保护;许可涵盖的是经筛选汇编而成的数据集。适合探索和可视化,不适用于运营。
- 经过筛选,并非详尽无遗: 收录的是世界各地知名的线路,而非地球上的每一条线路。线路名称和
highlight一句话简介均由作者撰写。 - 特意排除(仅在网站上提供,以保持出处清晰):各线路的故事和景点、照片(来自 Wikimedia Commons,采用单独许可),以及城市间行程指南(由公开时刻表数据源整理而成)。
- 底图 ≠ 数据: 交互式网站将这些线路显示在 OpenFreeMap(OpenStreetMap)瓦片上;这些瓦片不属于此数据集。OSM © OpenStreetMap contributors — 根据上文的出处说明,这一版权声明如今也适用于采用 OSM 描绘的线路本身。
许可与署名
- 事实数据(
data/中所有非几何字段):采用 CC BY 4.0 许可,可免费使用、分享和改编,但须注明来源为 World Train Map。链接到https://worldtrainmap.com(或url中的具体路线页面)即可满足署名要求。(完整声明) - 几何数据(
LineString坐标):如上所述,手工描绘的线条采用 CC BY 4.0 许可;基于 OSM 描绘的线条 © OpenStreetMap 贡献者,采用 ODbL 1.0 许可。如果你整体复用几何数据,请按 ODbL 处理并注明 OpenStreetMap,这是最稳妥的做法;下一次发布时,我们会在每条路线旁明确标注。 - 代码(
mcp/中的 MCP 服务):采用 MIT 许可。
另有以下平台可用
- Hugging Face: huggingface.co/datasets/Flightmussy/trainrouter-atlas,与此处的
data/逐字节同步 - Kaggle: kaggle.com/datasets/flightmussy/world-train-routes,仅包含两个事实数据文件,因为 Kaggle 只允许为数据集标注一种许可证,而几何数据部分采用 ODbL
- Zenodo(存档,DOI): doi.org/10.5281/zenodo.21322030,这是概念 DOI,始终指向最新发布版本(截至今天为 v1.1.0)
Kaggle 镜像是新建的,也值得说明一下它此前为何不存在:本 README 的所有早期版本,以及网站自己的数据集页面,都曾链接到 kaggle.com/datasets/albanius/... 下的页面。这个账号名称从来都不属于我们,而且镜像同步工作流中也将同一个错误 ID 硬编码了进去,因此该链接从写下的那天起就已失效,自动化流程也无法修复它。现在这两处都已更正。
引用
World Train Map Atlas:世界传奇铁路路线(2026)。worldtrainmap.com。DOI:10.5281/zenodo.21322030。https://github.com/Flightmussy/trainrouter-atlas
更新
数据由一个导出器从图集源生成,但该导出器目前有意暂停使用,等待完成上文所述的许可证拆分工作。这就是 data/ 自 7 月 23 日以来一直没有更新,以及最后一次发布仍为 v1.1.0 的原因。解除暂停后,新版本会优先发布在此处;发布 GitHub 版本会生成新的 Zenodo DOI,并通过 sync-mirrors.yml 推送到各镜像。当某个任务未配置 API 令牌时,该任务会自行跳过。
此仓库中还包含
mcp/— World Train Map MCP 服务的源代码(在线地址为https://worldtrainmap.com/mcp,在 Official MCP Registry 中的登记名称为com.trainrouter/atlas),可将图集作为工具提供给 Claude 和其他 MCP 客户端。该服务部署自网站自己的图集,而非data/,因此内容远比此处的文件新;不过它按自己的计划重新部署,可能会比网站本身稍有延迟。其atlas_stats工具会准确报告当前提供的内容。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。