Georgia Heritage

@pipeworx/georgia-heritage

**格鲁吉亚（国家）**的不可移动文化遗产国家名录 （საქართველო，位于高加索地区——不是美国的州）：由格鲁吉亚国家文化遗产保护局公布的 20,706 处纪念碑和遗产对象，可按名称、地点、类别和列入名录状态搜索，提供 WGS84 坐标以及将各对象列入名录的法令。

属于 Pipeworx 的一部分——一个将 AI Agent 连接到 1879+ 个实时数据源的 MCP 网关。这是一个独立、非官方的集成——与上游提供方无关联，未获其认可，也非由其发布。

工具

• georgia_heritage_search(query?, region?, municipality?, settlement?, category?, status?, classification?, physical_state?, period?, listed_only?, world_significance_only?, with_coordinates_only?, limit?, offset?) — 名录本身。返回筛选条件对应的真实总数（通过单独调用 returnCountOnly 获得，而非页面大小）、名录编号 RegNum、稳定的 ImmovableObjectID、坐标、列入名录的法令编号和日期，以及每条记录的 source_url + portal_url。
• georgia_heritage_object(reg_num? | object_id?) — 单个对象的完整信息： 描述、年代、初始和当前功能、实体状况、列入名录的文件记录，以及该局 在对象周围划定的实体和视觉保护区数量。
• georgia_heritage_nearby(latitude, longitude, radius_m?, limit?) — 某个 地点周边已登记的对象，按距离从近到远排列，并提供以米为单位的距离。
• georgia_heritage_facets(field, region?, municipality?, limit?) — 名录中某个字段 实际存储的不同取值及其数量。这是发现数据的步骤（见下文“所有内容都使用格鲁吉亚文字”）。
• georgia_heritage_museums(query?, region?, municipality?, limit?) — 该局登记的 20 家博物馆，包含访客联系信息、开放时间和门票价格。

身份验证

无需密钥。

数据源

• https://memkvidreoba.gov.ge/arcgisch/rest/services/Culture/CulturePortalService/MapServer/4 — 纪念碑／遗产对象名录，包含 20,706 条记录。该图层由该局自己的 公开地图查看器读取。
• .../MapServer/5 和 .../MapServer/6 — 实体保护区（9,741 条）和 视觉保护区（9,731 条），通过 ImmovableObjectID 关联。
• .../MapServer/7 — 博物馆目录，包含 20 条记录。
• 每个对象对应的公开名录页面： https://memkvidreoba.gov.ge/objects/immovable/immovableObject?id=<ImmovableObjectID>

Unicode 字面值需要 N 前缀——否则每个筛选结果都为零

名录将格鲁吉亚文字存储在 SQL Server 的 NVARCHAR 列中。 where=Municipality='მცხეთა' 返回 {"count":0}。where=Municipality=N'მცხეთა' 返回 {"count":480}。LIKE 也一样。无论哪种写法都不会报错——不带前缀的形式会正常返回 200，但要素数组为空，这属于 静默零值故障类别（docs/silent-zero-policy.md）。此程序包 放入 where 子句的所有字面值都会经过 sqlLit()，由它添加前缀。

所有内容都使用格鲁吉亚文字，因此拉丁字母查询匹配不到任何内容

数据中没有任何英文——名称、地点、类别词汇都没有。否则，调用者输入“church”或“Kakheti”只会得到一个干净的零结果。可通过两种方式缓解：

• LATIN_TERMS / LATIN_REGIONS 将常见的遗产相关词汇、12 个地区、较大的市镇和最知名的古迹映射为登记册中存储的格鲁吉亚语。每个条目都经过验证，确认能匹配到非零结果。响应会在 filters.query_terms 中报告实际搜索的内容，并在 filters.query_terms_unmapped 中列出无法翻译的内容。
• georgia_heritage_facets 列出存储的确切值及其计数，因此调用者可以查看某个地区／市镇／类别对应的格鲁吉亚语，并直接用它进行筛选。每个空结果都会指向该工具。

GLOSS 会为封闭词汇（状态、类别、分类、物理状态、地区）添加 *_en 英文标签，置于格鲁吉亚语旁边，让看不懂格鲁吉亚文字的调用者也能读懂输出。它刻意不会尝试翻译自由文本——对象名称和描述会原样返回，保持机构的原始写法。

其他值得了解的事项

• 标识符。 每条记录都有 ImmovableObjectID；许多已登记但未编号的对象（包括重要对象）的 RegNum 为 null（姆茨赫塔历史古迹群的 ImmovableObjectID 为 18026，但没有 RegNum）。存储任何数据时都应以 ImmovableObjectID 为键，而不是 OBJECTID 或 RegNum。
• 坐标。 XGr 是经度，YGr 是纬度，二者均采用 WGS84——同一图层中的 x / y 字段以米为单位，采用 EPSG:32638，并非你需要的坐标。有些记录的坐标为 0／null；with_coordinates_only 会将它们筛除。
• status 与 category。 20,706 条记录中有 10,822 条是已登记但未列出状态的对象——经过了调查，但并非古迹。listed_only: true 会将结果限制为具有古迹状态的 9,883 条记录。其中 1,799 条被归类为国家级重要对象，87 条被归类为世界级重要对象。
• 一个对象可能有多个边界多边形（一个建筑群分成多个部分登记），因此按 RegNum 查询可能匹配多行。georgia_heritage_object 会返回第一条，并通过 additional_boundary_records 报告其余记录，而不是将它们隐藏。
• nearby 会衡量两种不同的距离。 上游会针对每个对象的边界多边形执行半径筛选；distance_m 则根据登记册中记录的点计算。因此，大型遗址报告的距离可能超出半径，响应会在 distance_note 中说明这一点。
• ArcGIS 会在 200 响应中报告查询错误，内容包含 error 对象，且没有要素。此工具包会抛出这些错误，而不是返回空结果。
• 照片 URL 使用非标准端口（:60、:8443）——工具包会按机构发布的原样交给调用者，不会获取这些 URL。
• CreatorName / EditorName / CreateDate / EditDate 从不被选取。 这些是机构内部 CMS 的记录信息——即哪位工作人员录入了该行——与古迹本身无关。
• 登记册还涵盖位于当今国境之外、历史上属于格鲁吉亚领土的遗产（土耳其、阿塞拜疆、北高加索），以及阿布哈兹的遗产；Region 分面中会显示这些地区数量较少的记录。

快速开始

添加到你的 MCP 客户端（Claude Desktop、Cursor、Windsurf 等）：

{
  "mcpServers": {
    "georgia-heritage": {
      "url": "https://gateway.pipeworx.io/georgia-heritage/mcp"
    }
  }
}

此端点实际提供的内容

tools/list 在 https://gateway.pipeworx.io/georgia-heritage/mcp 返回上表中的工具，以及共享的 Pipeworx 元工具——ask_pipeworx、 discover_tools、search_within、remember/recall 和网关范围内的其他工具。因此，你看到的工具数量会多于表中所列：目前，单个资源包端点除了列出该资源包自己的工具，还会列出大约 30 个共享工具。连接的 initialize 响应会说明确切范围，是判断当天情况的权威依据。

这是有意为之，并非意外复用了多个服务。元工具让限定范围的连接也能回答此资源包未涵盖的问题——通过 ask_pipeworx 跨整个目录进行路由——无需再添加第二个 MCP 服务。目前无法挂载不含这些工具的资源包端点；如果额外的工具架构占用的上下文比路由带来的好处更多，不如只连接一次完整网关，而不是连接多个资源包端点。

或者，连接完整的 Pipeworx 网关，直接列出所有资源包的工具，而不只是此资源包的工具：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

两个 URL 都连接到同一个网关，访问相同的 1879+ 个数据源。唯一的区别是直接列出哪个资源包的工具；无论连接哪一个，ask_pipeworx 都能访问所有工具。

没有 MCP 客户端？通过 HTTP 调用

curl -X POST https://gateway.pipeworx.io/v1/tools/georgia_heritage_search \
  -H 'Content-Type: application/json' \
  -d '{"query":"monastery","region":"Kakheti","limit":2}'

首次调用无需账户。检查任意工具：GET https://gateway.pipeworx.io/v1/tools/georgia_heritage_search。查找工具：使用 {"query":"..."} 向 https://gateway.pipeworx.io/v1/tools/search_packs 发送 POST 请求。

独立运行（无需网关账户）

此软件包也可以作为本地 stdio MCP 服务运行——无需 Pipeworx 账户，也不必经由网关往返：

{
  "mcpServers": {
    "georgia-heritage": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-georgia-heritage"]
    }
  }
}

或者直接运行，以确认它能启动：

npx -y @pipeworx/mcp-georgia-heritage

它通过 stdin/stdout 使用 MCP，并为仅此资源包的工具响应 initialize/tools/list/tools/call——不包含上文网关连接所添加的任何共享元工具。来源相同，工具相同，但没有 ask_pipeworx 路由。

使用 ask_pipeworx

你可以用通俗易懂的英语提问，而不是直接调用工具——此方式既适用于上文的资源包端点，也适用于完整网关：

ask_pipeworx({ question: "your question about Georgia Heritage data" })

网关会自动选择合适的工具并填入参数。

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT