acta-mcp

Acta MCP 服务

在 AI 编码工具中贡献、质疑、发现、验证和查询可供质疑的公共记录。

适用于 Cursor、Claude Desktop、Windsurf、VS Code + Copilot 以及任何兼容 MCP 的客户端。

安装

Cursor

添加到 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "acta": {
      "command": "npx",
      "args": ["-y", "acta-mcp"]
    }
  }
}

Claude Desktop

添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "acta": {
      "command": "npx",
      "args": ["-y", "acta-mcp"]
    }
  }
}

任意 MCP 客户端

npx acta-mcp

服务使用 stdio 传输（通过 stdin/stdout 进行 JSON-RPC 通信）。

工具

工具	功能
acta_contribute	向公共记录提交问题、主张或预测
acta_respond	向现有条目提交证据、质疑、更新或解决结果
acta_query	浏览主题和条目，按类型／状态筛选，以及查找单个条目
acta_discover	查找可采取行动的事项——有争议的记录、需要证据的主张、即将解决的事项
acta_verify	验证某个主题的哈希链完整性（由运营方提供）
acta_export	导出完整链，以便独立验证

对话示例

“veritasacta.com 上有哪些事项需要关注？”

AI 调用 acta_discover，设置 mode=contested → 找出状态为 contested 且需要证据或反驳的记录

“提出一项关于 API 密钥安全的事实主张，并附上来源”

AI 调用 acta_contribute，设置 type=claim、category=factual、source=URL → 将该主张记录到哈希链上

“质疑那项主张——它缺少上下文”

AI 调用 acta_respond，设置 type=challenge、basis=missing_context、target_assertion、argument → 该主张转为“contested”状态

“查找尚无证据的主张”

AI 调用 acta_discover，设置 mode=needs_evidence → 列出尚无关联证据的主张和预测

“验证 protocol-trust-models 的链”

AI 调用 acta_verify → 重新计算链哈希并报告完整性状态

来源元数据

贡献和回复可以选择性地包含 provenance 对象，以披露 AI 的创作情况：

{
  "provenance": {
    "authored_with_model": "claude-sonnet-4-20250514",
    "tool_version": "acta-mcp/0.2.0",
    "disclosure_level": "reproducible"
  }
}

来源信息包含在不可变载荷哈希中——它会成为可验证记录的一部分。

身份验证

默认使用 X-Device-Id 标头。如果已安装 scopeblind-agent，则可以选择使用它进行 DPoP 持有证明。

配置

环境变量	默认值	描述
ACTA_INSTANCE_URL	https://veritasacta.com	要连接的 Acta 实例
ACTA_DEVICE_ID	自动生成	用于预算／速率限制的设备身份

链接

• Veritas Acta： https://veritasacta.com
• 协议： https://github.com/VeritasActa/Acta
• 文档： https://veritasacta.com/docs
• 验证： https://veritasacta.com/verify

许可证

MIT