mcpField
C
Clicks Protocol

Clicks Protocol

本地服务
github.com/clicks-protocol开发工具214 周前更新

关于 Clicks Protocol

Clicks Protocol 提供用于检查和核对 Base 上 Agent 商务结算的 MCP 工具。开发者可验证收据并查看结算证据,读取操作无需私钥。

主要功能

  1. 01验证 Receipt V2 完整性
  2. 02查看结算状态与见证信息
  3. 03核对 Base 证据但不提交交易
  4. 04比较收据绑定的策略哈希
  5. 05检查已配置的收据账本

适用场景

  1. 01检查结算收据是否完整
  2. 02重试结算前查看证据
  3. 03将收据与策略定义进行比较

MCP 相关

MCP 服务提供九种工具,包括用于验证、状态查询、核对、策略比较和账本检查的 Receipt V2 读取工具。写入工具需要 CLICKS_PRIVATE_KEY;读取工具接受收据 JSON,无需私钥。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"clicks-protocol": {
"command": "npx",
"args": [
"-y",
"@clicks-protocol/mcp-server"
],
"env": {
"CLICKS_PRIVATE_KEY": "<CLICKS_PRIVATE_KEY>",
"CLICKS_RPC_URL": "<CLICKS_RPC_URL>"
}
}
}
}
启动命令npx -y @clicks-protocol/mcp-server
需要配置的环境变量
CLICKS_PRIVATE_KEY密钥Private key for write operations (register, deposit, withdraw). Not needed for read-only tools.
CLICKS_RPC_URLBase RPC URL. Defaults to https://mainnet.base.org

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
npm@clicks-protocol/mcp-server0.3.2

工具

11

收录的工具列表 · 更新于 3 周前

参数类型必填说明
agent_addressstring是AI Agent 的 Ethereum 地址

详细介绍

Clicks Protocol MCP 服务

用于在 Base 上进行智能体商务结算路由和检查的 MCP 工具。

Receipt V2 读取工具

  • clicks_verify_receipt:验证确定性的 Receipt V2 完整性。
  • clicks_get_settlement_status:读取状态、见证信息和重试策略。
  • clicks_reconcile_settlement:读取 Base 上的证据,并提出故障关闭状态。它不会提交或重试交易。
  • clicks_replay_policy:将精确的策略定义与绑定到收据的策略哈希进行比较。
  • clicks_get_receipt_trail:读取配置的本地仅追加账本中的匹配版本。

设置 CLICKS_RECEIPT_LEDGER_PATH 以使用收据轨迹检查。其他 Receipt V2 工具直接接受完整的收据 JSON 对象,无需私钥。

安全边界

收据哈希有效仅能证明对象完整性,不能证明已交付或具有商业意图。RPC 数据缺失时会被视为未知,而不是证明未提交任何交易。只有通过独立证据确认的 SDK 状态 failed_before_transfer,才允许进行有界重试。

写入工具仍需要 CLICKS_PRIVATE_KEY。请将启用写入功能的 MCP 服务与公共或不受信任的客户端隔离。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。