AI导哈

地理空间数据处理工具

H3 MCP 是一个为AI代理提供空间推理能力的工具，通过将地理空间几何转换为可组合的H3集合操作。

  • by overnin
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 overnin/h3-mcp

使用说明

H3 MCP

H3 MCP通过将地理空间几何转化为可组合的H3集操作，为AI代理提供空间推理。

快速开始

  1. 安装依赖项：
python3.14 -m venv .venv
. .venv/bin/activate
pip install -r requirements.txt -r requirements-dev.txt
  1. 复制并配置环境：
cp .env.example .env
# Edit .env to set port, transport, and optional API key
  1. 启动服务器：
python src/h3_mcp/server.py

或者在开发模式（stdio）下：

mcp dev src/h3_mcp/server.py
  1. 运行测试：
pytest -q

建筑

Data Sources (GeoJSON/coords) -> H3 MCP tools -> summaries + cellset handles -> LLM reasoning

LLM在摘要上协调工具调用和原因。原始电池阵列是可选的，并受输出控制的限制。

工具参考

工具 目的 输出样式
h3_geo_to_cells 将GeoJSON索引到H3单元格中 summary, stats, cells
h3_k_ring 扩大服务范围 summary, stats, cells
h3_change_resolution 向上/向下移动H3层次结构 summary, stats, cells
h3_compare_sets 成对重叠指标 摘要+可选单元格
h3_compare_many N路比较 summary, stats
h3_cells_to_geojson 将单元格转换为多边形 summary, geojson, cells
h3_connected_components 将单元集拆分为连续的簇 组件列表
h3_cell_stats 单元格元数据和连续性 摘要
h3_aggregate 汇总数字属性 summary, stats, items
h3_find_hotspots 邻里z评分异常值 summary, stats, items
h3_distance_matrix 起点-终点跳距 summary, stats, items

为什么是MCP，而不是REST？

  • MCP工具是可组合的原语，而不是固定的工作流。
  • 代理可以在没有新端点的情况下，针对每个问题以不同的方式链接工具。
  • 工具注释和模式改进了模型规划和安全执行。

协调幻觉预防

  • 使用批量GeoJSON摄取(h3_geo_to_cells)而不是单一的lat/lng提示。
  • 通过 cellset_id 工具之间的句柄，以避免大的令牌有效载荷。
  • 默认为 return_mode="summary" 并且仅在必要时请求原始数组。

配置

服务器从读取设置 .env 文件（参见 .env.example):

变量 默认值 描述
H3_MCP_TRANSPORT streamable-http 运输： stdio, sse，或 streamable-http
H3_MCP_HOST 127.0.0.1 收听地址
H3_MCP_PORT 8000 监听端口
H3_MCP_API_KEY （空） 可选的承载令牌身份验证（省略以禁用）

技能

这 skills/ 目录包含编排指南，指导LLM代理如何链接H3 MCP工具。这 基本技能 涵盖了工具机制、令牌安全默认值和输出解释。 垂直技能 添加特定领域的词汇表、分辨率默认值、分析配方和解释指南。

技能 描述
skills/h3-mcp/SKILL.md 基本技能——工具参考、令牌安全默认值、解决方案指导、输出解释
skills/verticals/ev-infrastructure/SKILL.md 电动汽车充电沙漠、电网太阳能不匹配、需求热点、充电站附近
skills/verticals/telecom-coverage/SKILL.md 盲区检测、多操作员比较、信号热点、铁塔选址
skills/verticals/waste-management/SKILL.md 收集覆盖缺口、溢出热点、非法倾倒、设施邻近、服务公平

添加新的垂直领域 skills/verticals/<domain>/SKILL.md 使用基础技能中的模板。

例子

  • examples/waste_container_analysis.md
  • examples/solar_grid_mismatch.md

许可证

麻省理工学院（见 LICENSE).

相关 MCP