global-sentinel-mcp

global-sentinel-mcp

一个异步 MCP 服务，将预测市场、全球新闻事件、航空器状态和互联网基础设施遥测数据整合为一个用于宏观和金融分析的另类数据层。

状态：Beta — 已可用于生产环境；在 1.0 版本发布前，公共 API 仍可能调整。

---

为什么要开发它

另类数据——预测市场赔率、实时地缘政治事件流、实时航空器应答机数据以及互联网基础设施遥测数据——在宏观和金融分析中的重要性日益凸显。每个数据源都有各自的 API 结构、身份验证方式和更新频率，因此每次启动新项目时都要将它们接入，十分繁琐。

global-sentinel-mcp 通过单一 Model Context Protocol（MCP）接口封装四个公共数据源，填补了这一空白。LLM Agent 可以在同一处查询概率、事件、航空器状态和互联网遥测数据，无需了解上游 API 的细节。它还提供一个复合宏观警报工具，将新闻事件和故障注释融合为一个收敛信号，并附带易于理解的说明。

该服务完全异步（使用带重试传输的 httpx.AsyncClient），所有响应和错误均返回类型化的 Pydantic v2 模型；每个数据源都有 TTL 缓存，以遵守上游速率限制；只需一条命令即可通过 stdio 安装，无需 Web 服务。

---

可用工具

工具	数据源	返回内容
get_prediction_odds	Polymarket	按查询结果排序的事件赔率（概率百分比、交易量、结束日期）
get_prediction_event_by_id	Polymarket	特定事件 ID 或 slug 的赔率
lookup_aircraft_state	OpenSky Network	指定尾号（N 编号）或 ICAO24 十六进制代码的最新 ADS-B 状态
convert_nnumber	—（离线）	纯 Python FAA N 编号 ↔ ICAO24 转换，无需网络
get_global_events	GDELT 2.0	某个国家的高影响事件，按 Goldstein 量表排序
check_network_anomalies	Cloudflare Radar	BGP 劫持与泄漏，以及区域故障注释
get_macro_alert	GDELT + Cloudflare	带说明文本的复合收敛信号

---

快速入门

1. 安装

uvx global-sentinel-mcp

或从 PyPI 安装：

pip install global-sentinel-mcp

2. 设置环境变量（均为可选项——未设置时，工具会优雅降级）

# OpenSky — OAuth2 preferred (post-2025 migration), Basic Auth for legacy accounts.
export OPENSKY_CLIENT_ID="your_opensky_client_id"
export OPENSKY_CLIENT_SECRET="your_opensky_client_secret"
# Cloudflare Radar — required for BGP and outage tools.
export CLOUDFLARE_API_TOKEN="your_cf_token"
# Optional.
export LOG_LEVEL="INFO"

3. 运行

global-sentinel-mcp

该服务通过 stdio 使用 MCP JSON-RPC 协议通信。

本地开发

git clone https://github.com/ykshah1309/global-sentinel-mcp
cd global-sentinel-mcp
uv sync --dev
uv run global-sentinel-mcp        # run the server
uv run pytest tests/ -v           # run the test suite
uv run ruff check src/ tests/     # lint
uv run mypy src/                  # type-check

---

Claude Desktop 配置

添加到 claude_desktop_config.json（参见 claude_desktop_config.example.json）：

{
  "mcpServers": {
    "global-sentinel": {
      "command": "uvx",
      "args": ["global-sentinel-mcp"],
      "env": {
        "OPENSKY_CLIENT_ID": "your_opensky_client_id",
        "OPENSKY_CLIENT_SECRET": "your_opensky_client_secret",
        "CLOUDFLARE_API_TOKEN": "your_cf_token"
      }
    }
  }
}

Cursor 配置

添加到 .cursor/mcp.json：

{
  "mcpServers": {
    "global-sentinel": {
      "command": "uvx",
      "args": ["global-sentinel-mcp"],
      "env": {
        "OPENSKY_CLIENT_ID": "your_opensky_client_id",
        "OPENSKY_CLIENT_SECRET": "your_opensky_client_secret",
        "CLOUDFLARE_API_TOKEN": "your_cf_token"
      }
    }
  }
}

---

环境变量

变量	必需用途	描述
OPENSKY_CLIENT_ID	aviation（OAuth2，首选）	OpenSky OAuth2 客户端 ID — 免费注册
OPENSKY_CLIENT_SECRET	aviation（OAuth2，首选）	OpenSky OAuth2 客户端密钥
OPENSKY_USERNAME	aviation（旧版）	OpenSky Basic Auth 用户名（2025 年之前的账户）
OPENSKY_PASSWORD	aviation（旧版）	OpenSky Basic Auth 密码
CLOUDFLARE_API_TOKEN	BGP + outages	具有 Radar 读取权限的 Cloudflare API 令牌
LOG_LEVEL	—	Python 日志级别（DEBUG / INFO / WARNING / ERROR）。默认值为 INFO。

Polymarket 和 GDELT 工具无需身份验证。允许匿名使用 OpenSky，但速率限制非常严格。

---

数据来源

Polymarket（Gamma API）

众包预测市场数据。代币价格反映了大众对未来事件发生概率的估计。无需 API 密钥。事件以 JSON 编码字符串的形式提供 outcomes 和 outcomePrices — 客户端会解析“Yes”选项，并将其作为 probability_pct 返回。 文档

GDELT 2.0

全球最大的开放访问新闻事件数据库，每 15 分钟更新一次。事件包含行为者、事件类型、Goldstein 冲突/合作评分以及地理坐标。每个发布周期，服务只下载并解析一次 5 MB 的导出压缩包，随后通过内存中的 DataFrame 缓存响应所有国家/地区查询。 文档

OpenSky Network

由全球志愿者接收器网络提供的公共 ADS-B 航班追踪数据。可返回任何配备 Mode S 应答机的航空器的实时位置、高度、速度和地面状态。2025 年之后，该服务改用 OAuth2 客户端凭证；此服务会自动刷新令牌，并在凭证缺失时回退到 Basic Auth（旧版）或匿名访问。 文档

Cloudflare Radar

来自 Cloudflare 全球网络的互联网基础设施遥测数据。涵盖 BGP 路由异常（/bgp/hijacks/events、/bgp/leaks/events）和区域性服务中断注释（/annotations/outages，以前称为“traffic anomalies”，于 2024 年由 Cloudflare 更名）。需要免费的 Cloudflare API 令牌。 文档

---

贡献

有关设置说明、分支命名约定、测试要求和代码风格指南，请参阅 CONTRIBUTING.md。

---

许可证

MIT — 版权所有 (c) 2026 ykshah1309