castles

Castlemap MCP 服务

一个 Model Context Protocol 服务，适用于 Castlemap 图集：收录了 141 个国家的 7,786 座城堡、堡垒、宫殿和遗址，并提供坐标、建造日期、类别、知名度排名和维基百科摘要。

它已经在运行。将客户端指向托管端点即可——无需安装、注册或 API 密钥：

https://thecastlemap.com/mcp

采用 Streamable HTTP、无状态、仅支持 POST（返回 405 的 GET 请求是正确行为）。 接受协议修订版本 2025-06-18 和 2025-03-26。

客户端配置

{
  "mcpServers": {
    "castles": {
      "type": "http",
      "url": "https://thecastlemap.com/mcp"
    }
  }
}

注册表条目：com.thecastlemap/castles。

工具

工具	功能
search_castles	按名称、国家或类别查找城堡
get_castle	获取一座城堡的完整记录
castles_near	查找距离某坐标最近的城堡（使用 haversine 公式）；请先进行地理编码
top_castles	按知名度排名查找最知名的城堡
list_countries	列出 141 个国家及其数量
get_statistics	实时汇总数据——总数、各国统计和各世纪统计
random_castle	随机获取一座城堡

数据

数据源自 Wikidata，摘要来自维基百科，图片来自 Wikimedia Commons。该图集经过精选，并非收录所有内容：它涵盖有据可查的历史、真实照片和准确坐标的城堡，而非每一处土垒和遗址。

事实记录以 CC0 许可发布，并可从 thecastlemap.com/data 下载 GeoJSON 和 CSV 文件——也同步发布在 GitHub、 Hugging Face、 Kaggle 和 Zenodo（概念 DOI 10.5281/zenodo.21322359，始终指向最新版本）。

自行运行

server.mjs 零依赖——无需 SDK，也无需 node_modules。它需要 Node 18+ 和一个可供读取的 castles.geojson 文件（可从 /data 下载）：

CASTLES_GEOJSON=/path/to/castles.geojson PORT=8891 node server.mjs

默认绑定到 127.0.0.1:8891；可通过 HOST、PORT 和 CASTLES_GEOJSON 覆盖这些设置。文件修改时间发生变化时会重新读取（每 60 秒最多检查一次），因此更新数据无需重启。

castlemap-mcp.service 是生产环境中使用的 systemd 单元——绑定到环回地址，设置了 DynamicUser 和 ProtectSystem=strict，并由前置的 nginx 终止 TLS。请将 ExecStart 设置为你自己的 node 路径，并将 ReadOnlyPaths/CASTLES_GEOJSON 设置为数据所在位置。

来源

由 flightmussy 在 AI 协助下构建：概念、方向和审阅由我负责；大部分实现由 Claude 编写。底层数据并非生成所得——它来自 Wikidata，每条记录都可追溯到对应的 Wikidata 项目。

许可证

代码：MIT（见 LICENSE）。数据：CC0。维基百科摘要文本仍采用 CC BY-SA 许可，并在每条记录中注明来源。