Catalyst Edge Research

CATALYST/EDGE

为 AI Agent 提供带来源链接的市场情报。

Catalyst Edge 是一个本地、只读的模型上下文协议 服务，用于上市公司研究。询问 Agent 某个股票代码有哪些变化、为何重要、有哪些相互矛盾的信息，以及哪些来源支持答案。

它将 SEC 文件和所有权记录与可选的、受策略管控的来源相结合，生成精简的证据档案。每条结果都会保留来源链接和缺失数据警告。

本地优先。 证据和配置都保留在你的设备上。仅用于研究。 确定性评分器未经训练，也未经回测；Catalyst Edge 不提供投资建议、交易信号或交易执行。

---

安装

Catalyst Edge 需要 Python 3.10+ 和 uv。 SEC 要求提供可识别的 User-Agent；请使用你的组织名称和受监控的电子邮件地址。

Codex

codex mcp add catalyst-edge \
  --env 'CATALYST_EDGE_SEC_USER_AGENT=YOUR_ORGANIZATION YOUR_EMAIL' \
  --env 'CATALYST_EDGE_EVIDENCE_STORE=/absolute/local/path/evidence.sqlite3' \
  -- uvx --from 'catalyst-edge-mcp==0.1.8' catalyst-edge-mcp

开始一个新任务，并确认 Codex 能发现以下两个工具：

工具	用途
catalyst_edge_score	返回某个股票代码的精简催化因素证据档案。
catalyst_edge_claim_sources	分页查看某项主张背后的不可变来源记录。

Claude Desktop

下载 catalyst-edge-mcp-0.1.8.mcpb， 然后选择 Settings → Extensions → Advanced settings → Install Extension…。 出现提示时，输入相同的 SEC 身份信息。该扩展是未经签名的自定义捆绑包； 接受 Claude Desktop 的警告前，请先检查源代码和已发布的校验和。

---

使用

向你的 Agent 提出一个明确的研究问题，例如：

NVDA 在过去 14 天有哪些变化？请列出来源、缺失的证据，以及任何会削弱结论的信息。

主要工具接受股票代码、1–90 天的回溯范围、来源纳入选项和研究背景：

{
  "ticker": "NVDA",
  "lookback_days": 14,
  "include_sources": true,
  "include_raw_signals": false,
  "risk_mode": "research"
}

risk_mode 还支持 alert_triage 和 thesis_review。任何提供方组装前都会先验证股票代码；无效输入会明确报错，而不会生成不完整的评分。

在终端中使用

# Run the local stdio MCP server
uvx --from 'catalyst-edge-mcp==0.1.8' catalyst-edge-mcp

# Get a dossier directly
uvx --from 'catalyst-edge-mcp==0.1.8' catalyst-edge-score NVDA --lookback-days 14

---

使用的数据

证据	默认状态	说明
SEC 文件和所有权记录	已启用，需设置 CATALYST_EDGE_SEC_USER_AGENT	主要监管证据。
GDELT Web NGrams 发现功能	已启用	附带来源信息、仅缓存的发现元数据；设置 CATALYST_EDGE_GDELT=disabled 可选择退出。
发行方 RSS/Atom 订阅源	已禁用	显式设置 CATALYST_EDGE_ISSUER_FEEDS=enabled 以启用。
Bluesky 公开关注度	已禁用	显式设置 CATALYST_EDGE_BLUESKY=enabled 以启用；此信息并不完整，且仅作为中性背景。
期权、技术指标和情绪	已禁用	未经批准且权利已获许可的提供方，不会纳入组合。

默认的证据存储库是本地 SQLite，路径为 ~/.local/state/catalyst-edge-mcp/evidence.sqlite3。设置 CATALYST_EDGE_EVIDENCE_STORE 可指定其他本地路径。

检查本地就绪状态

CATALYST_EDGE_SEC_USER_AGENT='YOUR_ORGANIZATION YOUR_EMAIL' \
uvx --from 'catalyst-edge-mcp==0.1.8' catalyst-edge-smoke NVDA --lookback-days 14

冒烟检查会报告已清理的配置、来源信息、覆盖情况和就绪状态。 它绝不会输出凭据或提供方负载数据。

---

如何解读结果

每份档案都包含确定性的 score、direction、confidence、带来源链接的 证据、缺失或过时的类别，以及后续检查项。research.disposition 告知 Agent 应立即审查证据、持续关注，还是报告证据不足；它只用于确定研究优先级， 不是交易信号。此版本中的 model_status 始终为 not_trained。中性结果或无数据结果都是有效答案：缺失的 证据代表不确定性，而非看跌证据。

证据经过有意精简。使用带有声明 ID 的 catalyst_edge_claim_sources， 即可获取该声明分页后的来源记录，包括规范 URL、时间戳、哈希值、解析器 和策略决策。

{
  "ticker": "NVDA",
  "edge": {"score": 62, "direction": "bullish", "confidence": 0.69, "scoring_method": "deterministic_v1", "model_status": "not_trained"},
  "research": {"disposition": "review_now", "primary_claim_id": "clm_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "supporting_claim_ids": [], "contradicting_claim_ids": [], "blocking_gaps": [], "next_action": "Open SEC accession 0001045810-26-000001 and review the filed item text and exhibits."},
  "data_quality": {"coverage": "partial", "missing_families": [], "warnings": ["Deterministic v1 scoring is not backtested."]}
}

{
  "ticker": "NVDA",
  "edge": {"score": 50, "direction": "neutral", "confidence": 0, "scoring_method": "deterministic_v1", "model_status": "not_trained"},
  "research": {"disposition": "monitor", "primary_claim_id": null, "supporting_claim_ids": [], "contradicting_claim_ids": [], "blocking_gaps": ["options_flow"], "next_action": "Check whether a sector-wide event explains the observation."},
  "data_quality": {"coverage": "none", "missing_families": ["options_flow"], "warnings": ["options_flow provider yfinance is private diagnostic only; no production evidence or coverage credit was granted."]}
}

{
  "ticker": "NVDA",
  "edge": {"score": 50, "direction": "neutral", "confidence": 0, "scoring_method": "deterministic_v1", "model_status": "not_trained"},
  "research": {"disposition": "insufficient_evidence", "primary_claim_id": null, "supporting_claim_ids": [], "contradicting_claim_ids": [], "blocking_gaps": ["filings_news", "insider_trading", "options_flow", "social", "technical"], "next_action": "Retry with lookback_days=30 to check a wider filing window."},
  "data_quality": {"coverage": "none", "missing_families": ["filings_news", "insider_trading", "options_flow", "social", "technical"], "warnings": ["No live evidence adapters are configured."]}
}

---

隐私

结果和 SQLite 证据均保留在你的设备上。股票代码和发行方查询可能会 直接发送给你启用的公共来源提供方。SEC 身份信息仅会作为必需的请求 User-Agent 发送至 sec.gov。

请阅读 Catalyst Edge 隐私政策。

---

从源代码构建

uv sync --frozen --extra dev
uv run --frozen pytest
uv run --frozen ruff check .
uv build --no-sources --out-dir dist

默认测试在离线环境下运行，并使用经过脱敏的测试夹具。发布工作流会测试 Python 3.10 和 3.14、MCP 合约、干净构建以及打包后的构件。

许可证

MIT