CCS Verifier MCP

CCS Verifier MCP 服务

作为 Model Context Protocol 服务，免费且不限量地验证 CCS 收据。

这是什么？

这是 CCS（Cryptographic Commitment Scheme，密码学承诺方案）标准的公共验证器。它使用 Ed25519 签名验证 CCS 收据，以密码学方式证明 AI 评估确实如声明所述发生过。

主要特性：

• ✅ 永久免费——验证是一项公共服务
• ✅ 不限量——没有速率限制，无需 API 密钥
• ✅ 开源——采用 CC0 1.0（公有领域）许可，可自托管
• ✅ 与模型无关——适用于任何兼容 MCP 的客户端
• ✅ 不依赖大模型推理——纯密码学验证

快速开始

1. 安装 MCP 客户端

此服务适用于任何兼容 MCP 的客户端：

• Claude Desktop
• Cursor
• Continue
• 任何 MCP SDK 实现

2. 添加到 MCP 配置

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

3. 验证收据

向 AI 助手提问：

“验证这张 CCS 收据：{receipt_json}”

或者直接使用工具：

// Via MCP client
const result = await mcp.callTool('verify_receipt', {
  receipt: {
    receipt_id: "abc-123",
    evaluation_id: "eval-456",
    timestamp: 1699900000000,
    model_id: "gpt-4",
    prompt_hash: "sha256:...",
    response_hash: "sha256:...",
    commitments: ["commitment-1"],
    signature: "ed25519_signature_hex",
    public_key: "ed25519_public_key_hex"
  }
});

可用工具

verify_receipt

验证 CCS 收据的密码学完整性。

输入：

{
  "receipt": {
    "receipt_id": "string (required)",
    "evaluation_id": "string",
    "timestamp": "number (unix ms)",
    "model_id": "string",
    "prompt_hash": "string (sha256:hex)",
    "response_hash": "string (sha256:hex)",
    "commitments": "string[]",
    "signature": "string (hex, required)",
    "public_key": "string (hex, required)"
  }
}

输出：

{
  "valid": true,
  "confidence": 1.0,
  "receipt_id": "abc-123",
  "verification_id": "uuid",
  "verified_at": 1699900000000,
  "checks": [
    "structure_validation",
    "signature_verification",
    "timestamp_validation",
    "hash_integrity",
    "commitments_validation"
  ],
  "details": {
    "signature": {
      "valid": true,
      "algorithm": "Ed25519",
      "public_key": "abc123..."
    }
  }
}

get_verifier_info

获取验证器信息（版本、使用统计、定价）。

输出：

{
  "verifier": {
    "version": "1.0.0",
    "spec_version": "draft-correctover-ccs-11",
    "license": "CC0-1.0 (Public Domain)"
  },
  "usage": {
    "total_verifications": 12345,
    "successful": 12300,
    "failed": 45,
    "success_rate": "99.64%"
  },
  "pricing": {
    "verification": "FREE (unlimited)",
    "issuance": "Contact Correctover for licensing",
    "source_code": "CC0-1.0 (self-hostable)"
  }
}

generate_test_receipt

生成用于开发的测试收据（需要 Ed25519 私钥）。

**⚠️ 警告：**测试收据仅用于开发。生产环境中的收据必须由经授权的 CCS 发行方签发。

定价模式

此服务采用 CCS 生态系统的定价模式：

操作	费用	限制
验证收据	免费	不限量
签发收据	联系 Correctover	需授权
自托管验证器	免费	CC0-1.0

为什么验证免费？

要让 CCS 生态系统正常运作，验证必须免费且不限量：

1. 第三方验证建立信任——任何人都能验证，而不只是签发方
2. 网络效应——验证者越多 → 信任越高 → 签发方越多 → 收据越多
3. 公共服务——验证是基础设施，而非产品

我们如何盈利？

我们对签发（创建收据）收费，而非对验证收费。这种模式能够协调各方利益：

• 签发方付费，以获得创建可信收据的资格
• 验证者（你）可免费、不限量地进行验证
• 验证过程没有障碍，因此生态系统得以发展

CCS 标准

此服务实现了 draft-correctover-ccs-11，即 CCS 规范。

CCS 提供：

• AI 评估的密码学证明
• 可检测篡改的收据
• 与模型无关的验证
• 确定性、可复现的结果

自托管

验证器采用 CC0-1.0 许可（公有领域）。你可以自行托管：

# Clone
git clone https://github.com/DSHCorrectover/ccs-verifier-mcp.git
cd ccs-verifier-mcp

# Install
npm install

# Run
npm start

也可以使用 Docker：

docker run -i --rm correctover/ccs-verifier-mcp:latest

开发

# Install dependencies
npm install

# Run in dev mode (with watch)
npm run dev

# Run tests
npm test

# Build for production
npm run build

集成示例

LangChain

from langchain.tools import MCPTool

ccs_verifier = MCPTool.from_server(
    server_url="npx://ccs-verifier-mcp",
    tool_name="verify_receipt"
)

# Use in your chain
result = ccs_verifier.invoke({"receipt": receipt_data})

LlamaIndex

from llama_index.tools.mcp import MCPTool

ccs_verifier = MCPTool(
    command="npx",
    args=["-y", "ccs-verifier-mcp"],
    tool_name="verify_receipt"
)

直接使用 MCP SDK

import { Client } from '@modelcontextprotocol/sdk/client/index.js';
import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';

const transport = new StdioClientTransport({
  command: 'npx',
  args: ['-y', 'ccs-verifier-mcp']
});

const client = new Client({ name: 'my-app', version: '1.0.0' });
await client.connect(transport);

const result = await client.callTool('verify_receipt', { receipt });

安全性

此服务仅执行密码学验证。它不会：

• 存储收据
• 向外部服务传输数据
• 要求身份验证
• 产生副作用

安全特性：

• ✅ Ed25519 签名验证（128 位安全性）
• ✅ SHA-256 哈希校验
• ✅ 时间戳验证（24 小时窗口）
• ✅ 结构验证（防止输入格式错误）
• ✅ 除 MCP SDK 外无外部依赖

**报告安全问题：**参见 SECURITY.md

许可证

CC0 1.0 Universal（公有领域）

你可以复制、修改、分发和展示本作品，甚至用于商业目的，无需征求许可。

链接

• CCS Standard：draft-correctover-ccs-11
• GitHub：https://github.com/DSHCorrectover/ccs-verifier-mcp
• npm：https://www.npmjs.com/package/ccs-verifier-mcp
• MCP Protocol：https://modelcontextprotocol.io
• Issues：https://github.com/DSHCorrectover/ccs-verifier-mcp/issues

---

由 Correctover 构建 - 面向 AI 评估的加密证据基础设施。