Skip to main content
Glama

certified-mcp

ci license python tests mcp

给你的智能体一个它无法靠嘴皮子绕过去的东西。

一个 MCP 服务器,将证书验证、等价性证明和预注册密封暴露为工具。一个修改了设计、证明或基准配置的智能体,没有任何办法检查自己的工作——所以它只会报告成功。这些工具返回的裁决是从工件本身重新推导出来的,而不是对工件的主观断言。

安装

pip install "certified-mcp @ git+https://github.com/nickharris808/certified-mcp.git@main"

尚未发布到 PyPI。 名称 certified-mcp 尚未注册,所以 pip install certified-mcp 目前什么都装不了——请使用上面那一行,它安装的是完全相同的代码。当这个包发布后,这条说明会删除,直接用普通名称即可。

它的四个依赖项以 git 引用形式声明,所以那一行也会一并拉取它们。

Related MCP server: agent-gate

30 秒快速上手

在你的 MCP 客户端配置(Claude Desktop、Cursor 或任何 MCP 主机)中添加:

{
  "mcpServers": {
    "certified": { "command": "certified-mcp" }
  }
}

然后向你的智能体提出一个它原本只能靠猜的问题:

"我重构了这个加法器。证明它仍然与原始版本等价。"

prove_equivalence(inputs=["a","b"], circuit_a=[...], circuit_b=[...])
-> {"verdict": "EQUIVALENT", "receipt_verifies": true}

或者,当它不等价时:

-> {"verdict": "COUNTEREXAMPLE", "counterexample": {"1": true, "2": false}}

智能体会得到一个具体的失败输入,而不是"看起来没问题"。

工具

工具

功能

verify_certificate

从证书自身的数字重新推导制造准入裁决;检查完整性;拒绝未证明任何内容的证书包

explain_certificate

将 REFUTED/REJECT 裁决转化为具体清单:哪些位点是安全的、不安全的或跨界的,每个位点的裕量、所需裕量以及差距有多大。不计算任何新内容——它只是重新呈现裁决所依据的算术

verify_receipt

在已提交的公式上重新运行 DRAT 证明(或重新模拟反例)

prove_equivalence

证明两个小型组合电路等价,或返回一个产生差异的输入

check_drat

检查来自任何求解器的 DRAT 反驳;指出第一个不成立的引理

seal_criteria

在测量之前密封验收标准,且不泄露它们

check_seal

检测密封后被修改的标准

score_verifier

根据失败图谱对验证器进行评分

explain_defect

解释缺陷类别:为什么伪造看起来有效,以及什么能抓住它

为什么智能体特别受益

这直接针对三种失败模式:

  1. 自信的错误。 重构逻辑的智能体会说它保持了行为不变。 当它没有保持时,prove_equivalence 会返回一个反例输入。

  2. 移动球门柱。 针对基准调优的智能体会悄悄放宽阈值。 在运行前使用 seal_criteria 可以让这一点可被检测——包括被智能体自己检测到。

  3. 信任别人递给它的证明。 check_drat 接受来自任何求解器的证明并重新检查 每一个引理,所以伪造的证明会被抓住而不是被引用。

这里的一切都是本地的、只读的

无网络。不上传任何内容。无遥测。每个工具要么读取你指定的文件,要么对你传入的参数进行计算。

这些工具中没有一个能生成制造证书——只能检查证书。这种不对称是 故意的,并且由测试强制执行。检查是廉价的,应该无处不在;生成一份值得检查的 证书需要认证引擎,那是一个独立的闭源产品。

实现

仅使用标准库,MCP stdio 协议,约 300 行。你可以在决定运行它之前阅读整个 服务器——对于要接入一个具有文件系统访问权限的智能体的东西,你应该这样做。

许可证

Apache-2.0。

诚实的范围——这些工具证明了什么,以及它们不能证明什么

问题

答案

智能体可以用这些工具检查证书、证明或密封吗?

可以,全部在本地且只读。

verify_certificate 返回 UNVERIFIED 是否意味着证书是坏的?

不是。 它意味着工具因为缺少信任锚而弃权。智能体绝不能将其报告为通过或失败。

这里的任何工具能生成证书吗?

不能——由测试强制执行。这些是检查器。

这里有任何东西验证物理吗?

永远不会。


工具包的其他部分

记录的裁决是需要检查的主张,绝不是可以信任的输入。 九个仓库都建立在这个原则之上。

完整的故事以及被回答的质疑,都在 certified-oss ——如果这是你打开的第一个,请从那里开始。

lcert-verify

重新推导制造证书的裁决。仅标准库。

equiv-receipt

证明两个电路等价,并附带任何人都能重新检查的收据。

prereg-seal

在测量之前密封验收标准。

cert-atlas

28 个带标签的伪造品和一个任何退化验证器都无法获胜的指标。

certified-mcp

以上所有内容,作为你的 AI 智能体可以调用的工具。

lcert-verify-web

浏览器中的验证器。不上传任何内容。

现在试试,无需安装: 🔏 验证器 Space · 浏览伪造品: 📊 图谱数据集

免费版止步之处

这里的一切都是检查。没有一个是生成具有物理意义的证书——那需要 对真实过程模型进行可靠的包络计算,这是一个独立的商业产品。如果你 需要证书而不是检查证书的方法,那才是需要进行的对话。

文档

全组合集:教程 · 概念 · 常见问题 · 架构 · API 参考

许可证、引用、贡献

Apache-2.0——见 LICENSE。如果你使用这个项目,请引用它: CITATION.cff。

最有价值的贡献是一个本项目未能识破的伪造品—— 见 CONTRIBUTING.md 和 全组合集指南。


记录的裁决是需要检查的主张,绝不是可以信任的输入。

certified-mcp 是建立在这个原则之上的九个仓库之一。完整的故事以及被回答的质疑, 都在 certified-oss ——如果这是你 打开的第一个,请从那里开始。

Available Tools

9 tools
check_dratA

Check a DRAT refutation against a CNF in DIMACS form. Accepts proofs from any solver. Returns whether every lemma is RUP and, on failure, the index and content of the first lemma that does not follow.

Inputs: cnf_path (required), drat_path (required).

check_sealA

Check that an acceptance specification still matches its seal. Detects criteria that were changed after sealing. Returns matched=false with the two digests if they diverge.

Inputs: spec (required), seal, seal_path.

explain_certificateA

Explain WHY a certificate reached its verdict, locus by locus: which loci are safe, unsafe or straddling, the margin each had, the margin it needed, and how far short it fell. Use this after verify_certificate returns REFUTED or a certificate records a REJECT — it turns an opaque refusal into a specific, actionable list. Computes nothing new; it re-presents the arithmetic the verdict already rests on.

Inputs: bundle_dir (required), limit.

explain_defectA

Explain a certificate defect class from the atlas taxonomy: why the forgery looks valid, and which check catches it. Call with no key to list every defect.

Inputs: key.

prove_equivalenceA

Prove two small combinational circuits equivalent, or return a counterexample input. Circuits are given as gate lists over named signals. Returns a receipt any third party can re-check. Small instances only — this is a demonstration prover, not a production one.

Inputs: inputs (required), circuit_a (required), circuit_b (required), out_path.

score_verifierA

Score a verifier command against the certificate failure atlas. Returns detection (forgeries rejected), precision (valid artifacts accepted), and atlas_score = the minimum of the two, plus exactly which forgeries got through.

Inputs: command (required), atlas_dir (required).

seal_criteriaA

Seal an acceptance specification BEFORE measuring, so it cannot be adjusted afterward. Returns a digest that commits to the criteria without revealing them. Call this before running an experiment, not after.

Inputs: spec (required), note, out_path.

verify_certificateA

Verify a manufacturing certificate bundle. Re-derives the admission verdict from the certificate's own numbers rather than reading it, and checks integrity. Returns a verdict: VERIFIED, REFUTED, VACUOUS, or UNVERIFIED. IMPORTANT: without an expected_sha256 (a fingerprint obtained OUT OF BAND, not from the bundle itself) the verdict is UNVERIFIED — the tool abstains, because internal consistency alone cannot rule out a forgery whose inputs and verdict were edited together. UNVERIFIED means 'cannot tell', NOT 'the certificate is bad'. Do not report it as either pass or fail.

Inputs: bundle_dir (required), allow_empty, expected_sha256, accept_without_anchor.

verify_receiptA

Verify a logic-equivalence receipt. Re-runs the DRAT proof check (or re-simulates the counterexample) over the committed formula, and recomputes the hash chain. The verdict is re-derived, never read from the receipt.

Inputs: receipt_path (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.1/5.0

    Scored across 9 tools

    Disambiguation4/5

    Most tools have distinct purposes, but the verify_* family (verify_certificate, verify_receipt) and check_drat all involve checking proofs, which could cause confusion. However, the descriptions clearly differentiate artifact types and workflows.

    Naming Consistency5/5

    Tool names consistently follow a verb_noun pattern (e.g., verify_certificate, check_drat, explain_defect). No mixed conventions or vague verbs; every name conveys its action and target.

    Tool Count5/5

    With 9 tools, the server is well-scoped for a certification/verification domain. Each tool serves a clear role, and the count is within the ideal 3-15 range.

    Completeness4/5

    The toolset covers the core verification lifecycle: proving, checking, verifying, explaining, and sealing. Minor gaps exist (e.g., no tool to create certificates or manage the atlas), but these are likely external to this server's purpose.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that provides fact-checking capabilities and truth anchoring for AI agents using verified data sources.
      MIT
    • A
      license
      B
      quality
      C
      maintenance
      An MCP server that enforces fail-closed deterministic checks, independent refute-first review, and tamper-evident hash-chained receipts for AI agent outputs before claiming completion.
      4
      3
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      MCP server that enables AI agents to verify each other's trust scores, register, submit reviews, and find trusted agents before transacting.
      4
      20 npm
      MIT