拖时间轴看古海岸线后退:2400 年历史地图册把「哪年哪地」做成了 MCP 工具

拖时间轴看古海岸线后退:2400 年历史地图册把「哪年哪地」做成了 MCP 工具

5天前
duguying
5 阅读
来源:GitHub

2400 年历史地理压成一条可拖动的时间轴:18 个时期、198 幅疆域快照,v1.3.0 加入古海岸线演变与三场大事沙盘;更特别的是它附了零依赖 MCP server,模型只需给 year 和 place 就能出图。

相关标签

#GitHub#Trending#历史地理#MCP#可视化

读古诗时最常见的困惑不是字不认识,而是地名对不上号:建康在今天的哪、黄州为什么能写出《赤壁赋》、韩愈在蓝关停下马时到底站在秦岭的哪个口子。这些答案散在历史地图集和方志里,翻起来费劲,做成网页又往往只是「一张能缩放的图」。

「江山时序」(jiangshan-map)走的是另一条路:把 403 BCE 至今的 2400 多年压成一条可拖动的时间轴,18 个历史时期、198 幅疆域快照、526 条时间轴大事,配合古地名、关隘、诗文与战场地标、纪年与在位帝王一起呈现。它是个纯静态站——克隆下来用任意静态服务器打开就能跑,也提供了 nginx 的 Docker 镜像。

11 月 13 日的 v1.3.0 里,最有意思的一项更新是「古海岸线演变」。渤海湾与黄河三角洲、苏北与长江口、珠三角三处,各按「东汉以前 / 魏晋至北宋 / 金·南宋至清中期」分三期随年代进退,另加了 1823 年以前的台南台江内海;拖动时间轴,能看到渤海湾西岸、苏北平原、崇明岛和珠三角一步步成陆。沿海政权与政区边界统一贴合山东半岛、浙闽粤的基岩海岸,黄河、海河、淮河、长江的河口则按年代收束到当时的入海位置。

同期加入的「点事溯局」把三场大事做成了双阵营沙盘:安史之乱、靖康之变、楚汉之争各以 10 个节点、三幕展开,攻守路线用两种颜色区分,跨朝代时底图随年份切换,在搜索框输入事件名或点时间轴旁的「始末」即可进入。此外还有按需加载的 z5–z6 山体晕渲瓦片(约 2 km / 1 km 每像素,数据来自公有领域的 SRTM / GMTED2010 / ETOPO1)、随播放朗读纪年与年号的语音讲解、以及把时间轴两端向内拖可将短朝代放大最多 16 倍的裁剪缩放。

真正让它区别于普通历史地图站的是接口层。项目附带一个零依赖的 stdio MCP server,暴露三个工具:inspect_place 返回某年某地的在位帝王与年号、所属政权、郡/州/府与今省市、2400 年沿革和可分享链接;inspect_person 返回人物生平和跨朝代的落脚点;search_atlas 在全部古地名、关隘、人物、年号、大事里检索。README 标注离线响应在 5 毫秒内。更省事的是零坐标 URL 协议:模型只需从诗文里抽出 year 和 place 两个语义参数,页面自己解析古今地名、定位镜头、渲染疆域与轨迹——单点(?year=819&place=蓝关)、同年多站(杜甫 763 年的剑外到洛阳)、跨年轨迹(苏轼湖州到儋州)都能直接出图。另有 CLI 截图脚本与浏览器内的 window.atlasAPI / WebMCP 注册,方便 Agent 与自动化环境调用。

数据侧的克制值得一提。所有几何以拓扑去重的 VLQ 包发布,提供 GeoJSON 导出脚本(覆盖 403 BCE 至 1948),但郡/州/府图层因源自 CHGIS、其条款禁止再分发,默认不导出,需要 --with-prefectures 且仅限本地学术用途。v1.3.0 同时把首屏同步脚本从 576 KB 压到 374 KB(gzip,−35%),人文详情、繁体转换、古地名小试改为按需加载,并在 CI 里设了首屏体积预算;史籍出处也已建 data/sources/ 并接入 CI 审计,目前 1455 条大事、事件、行迹与人物中有 139 条标注了出处,秦、楚汉、东晋十六国、隋等时段的文字对照《史记》《汉书》《资治通鉴》《隋书》做过校正。

一个静态的历史图册,最后变成了模型可以调用的地理接口——这大概是它今天被推到榜单前列的原因。项目为 GPL-3.0,README 提供简中、繁中、英、日四种语言。

仓库地址:https://github.com/DeanChensj/jiangshan-map

返回列表

更多资讯

想看更多优质内容?

浏览所有资讯