H3 MCP
H3 MCP通过将地理空间几何转化为可组合的H3集操作，为AI代理提供空间推理。
快速开始
- 安装依赖项：
python3.14 -m venv .venv
. .venv/bin/activate
pip install -r requirements.txt -r requirements-dev.txt- 复制并配置环境：
cp .env.example .env
# Edit .env to set port, transport, and optional API key- 启动服务器：
python src/h3_mcp/server.py或者在开发模式（stdio）下：
mcp dev src/h3_mcp/server.py- 运行测试：
pytest -q建筑
Data Sources (GeoJSON/coords) -> H3 MCP tools -> summaries + cellset handles -> LLM reasoningLLM在摘要上协调工具调用和原因。原始电池阵列是可选的，并受输出控制的限制。
工具参考
| 工具 | 目的 | 输出样式 |
|---|---|---|
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//SKILL.md 使用基础技能中的模板。
例子
examples/waste_container_analysis.mdexamples/solar_grid_mismatch.md
许可证
麻省理工学院（见 LICENSE).