Frame Check

看看任何文档没有向你展示的内容。

Frame Check 是一个结构化框架分析工具。它能指出文档采取了哪些视角、忽略了哪些视角，以及它是如何定位读者的。在有覆盖范围的情况下，它还会对照权威来源对数值声明进行交叉核对。

快速入门 (MCP 服务器)

PyPI 软件包 frame-check-mcp 是模型上下文协议 (MCP) 服务器。它在本地运行，并为任何兼容 MCP 的 AI 客户端（Claude Desktop、Cursor、Cline、Continue.dev 等）提供确定性的结构化框架分析工具。

pip install frame-check-mcp

然后将你的 MCP 客户端指向已安装的入口点。对于 Claude Desktop，请添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "frame-check": {
      "command": "frame-check-mcp"
    }
  }
}

重启客户端。然后在任何对话中输入：“你能对这份文档进行框架检查吗？”完整的安装和验证详情请参阅 MCP_SERVER.md。

Related MCP server: Analysis MCP

功能介绍

传入一份文档，Frame Check 将返回：

• 结构化框架概况：文档涵盖了五种分析视角（原因、风险、利益相关者、趋势、不确定性）中的哪几种，忽略了哪些，以及每种视角的密度。

• 语调和认知姿态：文档如何定位读者，以及有多少比例的声明归因于来源。

• 时间取向：文档是将结论建立在历史数据、现状还是预测之上。

• 框架词汇标准 (Frame Vocabulary Standard) 候选匹配：命名框架模式，其基于规则的信号会在文本上触发，每个模式都带有识别线索和工作示例。匹配属于候选级别；针对多源标注的精确度是一个正在研究的课题。

• 来源网络验证：针对 SEC EDGAR、FRED、世界银行、REST Countries、Alpha Vantage 和 Wolfram Alpha 等提供商有覆盖范围的数值声明进行核对。

• 可选的 AI 叙述，在散文层面解释框架。标注清晰，以便读者不会将语言模型的解释与确定性测量混为一谈。

方法

结构化测量是基础。工具做出的每一项框架声明都是通过确定性模式匹配器计算得出的，并且对于相同的输入总是返回相同的结果。如果配置了 API 密钥，AI 辅助解释可作为增强功能提供，但会进行相应标注，绝不会隐藏在结构层之后。

验证是有边界的。该工具仅针对对声明类型具有真实覆盖范围的提供商验证数值声明，并且它会展示其自身的校准结果（每个提供商的精确率、召回率、F1 值），而不是在没有证据的情况下断言结论。

命名模式检测是独立于结构概况的可靠性层。在预注册验证中，检测器对专家标注者的 F1 = 0.36，低于 0.4 的有用阈值。在 v0 版本中，重点转向构建诚实度呈现（欠检测标记、密度警告、置信状态）而非自信的标签，这是支撑性的主张；一项读者辅助研究（Track B，预注册）正在测试这种呈现方式是否真的能帮助读者看到他们原本会错过的框架。

诚实的局限性和预期的对抗性解读已在 ANTICIPATED_CRITIQUES.md 中编目。

文档

• METHODOLOGY.md — 完整方法论论文 (v0.2 草案)

• MCP_SERVER.md — MCP 服务器参考（工具、资源、提示词）

• MCP_CLIENT_CONFORMANCE_v1.md — 针对已安装 wheel 的 32/32 一致性往返测试

• FRAME_DIVERGENCE_v1.md 和 FRAME_DIVERGENCE_v2.md — 差异架构

• data/frame_library/ — 包含 20 个条目的 FVS 目录及工作示例

• ANTICIPATED_CRITIQUES.md — 自行枚举的对抗性解读

• VALIDATION_PROGRAM.md — 观察性 + 正式验证计划

运行测试

pip install -r requirements.txt
python3 run_tests.py

49 个测试套件，约 3 分钟。包括 test_mcp_adversarial.py 中的 63 个对抗性调度程序测试，以及 V4.2 引擎 + 分类器覆盖范围。

许可证

代码采用 Apache-2.0；FVS 库和工作示例采用 CC-BY-4.0（请参阅 NOTICE 获取各目录的枚举）。

引用

如果 Frame Check 对你的工作有帮助，请参阅 CITATION.cff 获取可引用格式。Frame Check 由 Lovro Lucic 创作；根据构建诚实度原则，署名是该项目的主要信誉资产。

贡献

根据 CONTRIBUTING.md 要求签署 DCO。治理遵循 GOVERNANCE.md（BDFL 模型，具有用于规范推广决策的命名强制函数）。外部评审员参与遵循 REVIEWERS.md。

问题

https://github.com/lluvr/frame-check-mcp/issues