France Geodata

@pipeworx/france-geodata

针对法国公共地理数据的地点和半径查询：市镇及人口、某点周边的建筑、某点的土地覆盖，以及某地的洪水风险记录。每次调用都是实时的按请求代理；不会复制或存储任何数据。

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

工具

• fr_commune(name | insee_code | lat+lon, limit?) — 市镇登记信息：INSEE 代码、邮政编码、人口、面积、中心点、省和大区。“里昂的人口”会返回 69123、519,127。
• fr_buildings_near(lat, lon, radius_m?, limit?, include_geometry?) — 某点 500 m 范围内的建筑，按距离从近到远排列；每栋建筑包含 GeoJSON 多边形、高度、楼层数、住宅数、用途和性质。会报告 total_matched 和 truncated；每次调用最多对 200 个候选项排序。
• fr_land_cover(lat, lon) — 包含该点的多边形所对应的 CORINE Land Cover 2018 类别（代码和标签）。覆盖范围外返回 found:false。
• fr_flood_zones(lat, lon, radius_m?) — 该点所在市镇登记的洪水灾害信息、洪水区地图集，以及半径范围内的重大洪水风险区域。

相关工具包：ban-fr（地址、反向地理编码）、france-dvf（房产销售）。

认证

无需密钥。

数据源

• Etalab / INSEE，市镇登记信息 — 名称、代码、人口。
• IGN，BD TOPO — 建筑轮廓及属性。
• Copernicus / IGN，CORINE Land Cover 2018 — 土地覆盖类别（制图单元为 25 ha，因此描述的是某点周边环境，而非该点本身）。
• Géorisques（法国生态转型部），GASPAR — 洪水风险记录。

留给下一位维护者的说明

• fr_flood_zones 查询的是登记信息，而非地块级洪水多边形。IGN 平台上没有全国性的洪水多边形图层（只有零散的地方规划），而灾害登记的预防规划端点会忽略位置筛选条件，因此不使用该端点。没有记录并不能证明没有洪水风险，该工具会对此作出说明。
• 洪水数据源会重置来自某些住宅网络和办公网的连接，但可通过 Cloudflare 边缘节点正常响应。请从 Worker 验证，而非从笔记本电脑验证。
• 建筑筛选器以纬度为先（WGS84 的 OGC 轴顺序）；土地覆盖筛选器需要显式指定 SRID，并以经度为先。混用会导致 HTTP 200 但返回空集，看起来像是“这里没有建筑”。
• 建筑数据源会以 HTTP 200 返回 XML 格式的 OGC 异常；系统会将其作为错误呈现，而非空结果。
• 建筑：匹配项超过 200 个时，系统会对数据源返回的前 200 个结果排序，因此可能遗漏距离更近的建筑；请缩小 radius_m。该工具会对此作出标记。

快速开始

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

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

此端点实际提供的内容

https://gateway.pipeworx.io/france-geodata/mcp 上的 tools/list 会返回上表中的工具，以及共享的 Pipeworx 元工具——ask_pipeworx、 discover_tools、search_within、remember/recall，以及其余网关级工具。因此，你看到的工具数量会多于此表：目前，单个工具包端点除自身工具包的工具外，还会列出大约 30 个共享工具。连接的 initialize 响应会说明其确切范围，并且是当天适用的权威答案。

这是有意为之，并非意外的多路复用。元工具可以让限定范围的连接回答此工具包无法处理的问题——通过 ask_pipeworx 在整个目录中进行路由——而无需添加第二个 MCP 服务。目前无法挂载不包含这些工具的工具包端点；如果额外的架构定义占用的上下文超过路由带来的收益，请连接一次完整网关，而不是连接多个工具包端点。

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

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

两个 URL 都连接到同一个网关和相同的 1878+ 个数据源。唯一的区别是哪个工具包的工具会被直接列出；从任一端点都可以通过 ask_pipeworx 访问所有工具。

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

curl -X POST https://gateway.pipeworx.io/v1/tools/fr_commune \
  -H 'Content-Type: application/json' \
  -d '{"name":"Lyon","limit":3}'

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

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

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

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

或者直接运行以确认其可以启动：

npx -y @pipeworx/mcp-france-geodata

它通过 stdin/stdout 使用 MCP 协议，并仅针对此工具包的工具响应 initialize/tools/list/tools/call——不包含上述网关连接额外提供的任何共享元工具。源代码相同，工具相同，但没有 ask_pipeworx 路由。

使用 ask_pipeworx

你也可以用通俗语言提问，而不是直接调用工具——这既适用于上文的工具包端点，也适用于完整网关：

ask_pipeworx({ question: "your question about France Geodata data" })

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

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT