☰
自定义地理围栏监控:world-intel-mcp AOI工具组完整使用指南(圆形/多边形/走廊)
2026/10/23 2:02:38 网站建设 项目流程
  • MCP 服务
  • AI 应用
  • 人工智能
  • 数据集成
  • 后端

【免费下载链接】world-intel-mcp

160-tool MCP server for real-time global intelligence from free public APIs: markets, liquidity, prediction markets, SEC filings, conflict, military, aircraft-cohort early warning, migration and border flows, cyber, climate, news and more. Dated observation history, 29 research prompts, cited briefs, geofences, SSE dashboard. MIT, no paid API keys.

项目地址:https://gitcode.com/gh_mirrors/wo/world-intel-mcp
点击查看免费下载

world-intel-mcp 是一个基于 160 个 MCP 工具的实时全球情报服务器,数据全部来自免费公开 API。它的AOI(Area of Interest,兴趣区/地理围栏)工具组让你可以自定义监控任意地区:支持圆形、多边形、走廊三种形状,提供带引用的多域情报简报、热点升级评分和"进入/离开"变化检测,并可在重启后跨会话持久保存。本文带你从零完成自定义地理围栏监控的完整配置。

上图是 world-intel-mcp 的运营中心仪表盘,左侧图层面板中可以开启你定义的 AOI geofence 图层及其最近一次扫描计数。

为什么需要自定义地理围栏监控

在 AOI 工具组出现之前,只有 22 个内置热点(INTEL_HOTSPOTS)能享受升级评分,其他工具只能查"现在全球"而不是"你关心的这个地方"。intel_aoi_*工具组补齐了这一点:

  • 🎯命名你的区域:一座城市、一段边境、一条海峡、一条补给线
  • 📄同样的多域待遇:地震、军机、冲突、野火、新闻,按精确形状过滤
  • 🔔告警原语:intel_aoi_changes报告自上次扫描以来什么进入/离开了围栏
  • 💾持久化:围栏存于 SQLite 缓存库的专用aois表中,重启不丢失

工具定义位于 src/world_intel_mcp/tools/aoi.py,核心几何与持久化实现在 src/world_intel_mcp/analysis/aoi.py。

AOI 工具组全家福:10 个工具一览

工具作用
intel_aoi_define定义圆形围栏:名称 + 中心点 + 半径(1–2000 km)
intel_aoi_define_polygon定义多边形围栏:3–64 个 [lat, lon] 顶点(海峡、边境、专属经济区)
intel_aoi_define_corridor定义走廊围栏:2–64 个航路点 + 总宽度(航道、补给线、海缆走廊)
intel_aoi_list列出全部已定义围栏
intel_aoi_update重命名任意围栏;圆形围栏可原地改中心/半径
intel_aoi_delete按名称删除围栏
intel_aoi_brief生成带引用的多域情报简报
intel_aoi_escalation对你的围栏跑热点升级评分(0–100)
intel_aoi_changes报告自上次扫描以来进入/离开围栏的事件
intel_aoi_digest一次调用扫描全部围栏(或指定子集),输出合并摘要

定义自定义地理围栏的三种形状

圆形围栏:点 + 半径,最快的方式

适合城市、设施等"一个点加一个范围"就能表达的区域。名称大小写不敏感,重名会礼貌地回显已有定义而不是覆盖。

intel_aoi_define(name="Pittsburgh", lat=40.4406, lon=-79.9959, radius_km=50)

参数约束:lat在 -90..90,lon在 -180..180,radius_km在 1..2000。圆形围栏可以横跨反子午线(国际日期变更线)——白令海峡或斐济的 AOI 会自动拆成两个查询框覆盖两侧,不会丢掉一半覆盖。

多边形围栏:圈住半径表达不了的区域

边境地区、海峡、专属经济区这类不规则形状,用 3–64 个顶点勾勒边界:

intel_aoi_define_polygon(name="Taiwan Strait", vertices=[[22.5, 118.0], [22.5, 121.5], [26.5, 122.0], [26.5, 118.5]])

归属判定按精确多边形执行(bounding circle 只是粗筛),落在包围圆内但多边形外的事件会被排除。多边形可跨反子午线,但经度跨度最多 180°、包围半径不超过 2000 km。

走廊围栏:监控航道与线路型资产

给一条由 2–64 个航路点组成的路线加上总宽度(1–500 km)即可:

intel_aoi_define_corridor(name="Suez Approach", waypoints=[[29.9, 32.55], [27.5, 34.0], [24.0, 36.0]], width_km=80)

成员关系 = 距离大圆路线 ≤ width/2;结果中的距离是到路线的距离而非到某个中心的距离。适合监控航运通道、补给公路、海缆走廊。

💡 三种形状通用全部intel_aoi_*工具:简报、评分、变化检测都按精确形状作用。

区域情报简报:intel_aoi_brief

定义好围栏后,一条命令拿到该区域的带引用简报:

intel_aoi_brief(name="Taiwan Strait")

简报涵盖:

  • 地震(USGS)、军机(bbox 由形状推导)、野火(按区域映射)、ACLED 冲突事件、抽样航空流量
  • 附近静态基础设施:军事基地、港口、油气管线、核设施、海缆、数据中心、航天发射场,均带公里距离
  • 新闻:通过 OSM Nominatim 反向地理编码,定位到围栏中心所在的城镇与县,再查该地新闻

每一条都带[n]引用指向编号sources列表;data_gaps会点名每一个无法圈定到该围栏的领域(例如围栏落在 NASA FIRMS 覆盖区之外),而不是静默省略——这也是该项目"诚实降级"设计哲学的体现。

升级评分:intel_aoi_escalation 量化区域风险

intel_aoi_escalation(name="Pittsburgh")

这套评分与内置 22 个热点用的是同一引擎:基线、新闻、军事、冲突、社会动荡、多域收敛六个分量,总分 0–100。因为自定义围栏没有策划基线,基线分量为 0,得分上限为 80(score_ceiling会给出本次调用的实际上限)。几个值得注意的防误报设计:

  • 新闻分量只统计上升,GDELT 摄取不均的周不做对比
  • 数据源没响应或只返回过期缓存时,分量记为null并写入data_gaps,绝不记为 0
  • computed_from/zero_filled_components/lower_bound_components会说明分数由哪些分量算出、哪些 0 是抓取失败所致

变化检测:什么进入或离开了(intel_aoi_changes)

这是 AOI 组的告警原语:

intel_aoi_changes(name="Suez Approach") # 上次扫描以来进入/离开了什么
  • 覆盖地震、军机、ACLED 事件、野火簇、新闻提及五个领域
  • 第一次调用建立基线(不声称有任何进出),之后每次调用报告新增、离开、未变事件
  • 抓取失败的领域记入data_gaps并从 diff 中剔除——失败的抓取永远不会被读成"全撤了"

一键扫描全部围栏:intel_aoi_digest 与自动化守护

当你定义了多个围栏时,不必逐个调用 changes:

intel_aoi_digest() # 一次扫描所有围栏 intel_aoi_digest(names=["A", "B"]) # 只扫描指定子集

配合 collector 守护进程,即可实现无人值守的地理围栏监控(实现见 src/world_intel_mcp/collector.py):

intel-collector --daemon --sources aoi --interval 900 # 每 15 分钟扫描一轮全部围栏

设置环境变量WORLD_INTEL_AOI_WEBHOOK后,任何一次扫描发现围栏内有事件进入或离开,就会向该 URL 发 POST(安静的扫描不触发);加上WORLD_INTEL_AOI_WEBHOOK_FORMAT=text可获得带Title头的原始 markdown 正文,可直接喂给 ntfy 类推送服务。

围栏日常管理:列出、改名、删除

命令行同样提供九个操作:intel aoi define | define-polygon | define-corridor | list | update | delete | brief | escalation | changes(CLI 实现见 src/world_intel_mcp/cli.py)。例如:

intel aoi define Pittsburgh --lat 40.4406 --lon -79.9959 --radius-km 50 intel aoi define-corridor "Suez Approach" \ --waypoint 29.9,32.55 --waypoint 27.5,34.0 --waypoint 24.0,36.0 --width-km 80 intel aoi list

关于intel_aoi_update的两个要点:

  • 改名保留变化检测历史;改动中心或半径会重置快照——因为旧基线描述的是另一块地方,直接 diff 会伪造进入/离开事件
  • 多边形/走廊围栏的 lat/lon/radius 是由形状派生的,只能改名;要改形状需删除后重新定义

参数范围速查表

形状参数范围
圆形radius_km1 – 2000 km
多边形vertices3–64 个顶点;经度跨度 ≤ 180°;包围半径 ≤ 2000 km
走廊waypoints/width_km2–64 个航路点 / 总宽 1–500 km;包围半径 ≤ 5000 km
通用name非空字符串,大小写不敏感的唯一键

AOI 持久化在主缓存库($WORLD_INTEL_CACHE_DB或~/.cache/world-intel-mcp/cache.db)的专用aois表中,因此调度器可以在重启后继续盯着你命名的每一片区域。

总结

  • 用intel_aoi_define/define_polygon/define_corridor按区域形状选对围栏类型
  • 用intel_aoi_brief拿到带引用的区域情报简报,用intel_aoi_escalation量化风险
  • 用intel_aoi_changes+intel_aoi_digest建立"进入/离开"告警,配合 collector 守护与 webhook 实现自动化监控
  • 所有工具在 README.md 的 "AOI Geofences" 一节有完整说明,核心逻辑可对照 analysis/aoi.py 阅读
  • MCP 服务
  • AI 应用
  • 人工智能
  • 数据集成
  • 后端

【免费下载链接】world-intel-mcp

160-tool MCP server for real-time global intelligence from free public APIs: markets, liquidity, prediction markets, SEC filings, conflict, military, aircraft-cohort early warning, migration and border flows, cyber, climate, news and more. Dated observation history, 29 research prompts, cited briefs, geofences, SSE dashboard. MIT, no paid API keys.

项目地址:https://gitcode.com/gh_mirrors/wo/world-intel-mcp
点击查看免费下载

相关推荐

上一篇:Hilt ViewModel注入终极指南:Pokedex中的依赖管理最佳实践
下一篇:AndroidFastScroll:终极Android快速滚动库,让RecyclerView滚动速度提升3倍

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询