关于 Sekisho MCP
Sekisho MCP 是供 OpenCode、Claude Code、Codex 等 MCP 客户端使用的本地服务,可调用 Avalanche 上远程 MCP 服务的 x402 付费工具。它显示工具价格,并在签署付款前执行单次和滚动 24 小时 USDC 限额。
主要功能
- 01以 USDC 支付 x402 工具调用
- 02设置单次与 24 小时支出上限
- 03在工具描述中显示价格
- 04将付款密钥保存在私有文件中
- 05查看钱包、网络、限额和近期支出
适用场景
- 01让 Agent 调用 Avalanche 上的付费 MCP 工具
- 02限制每次工具调用的支出
- 03检查钱包和近期付款总额
MCP 相关
它以本地 MCP 服务运行,通过 Streamable HTTP 连接远程付费 MCP 服务,并向 MCP 客户端提供其工具。支持的 x402 调用会按配置的限额付款。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
npx -y @zero-two-labs/sekisho-mcpSEKISHO_MCP_URLRemote paid MCP server (Streamable HTTP), e.g. https://sekisho-api.zerotwolabs.xyz/mcpSEKISHO_NETWORKavalancheFuji (testnet) or avalanche (mainnet, real USDC)SEKISHO_MAX_PER_CALLMax USDC per tool callSEKISHO_MAX_PER_DAYMax USDC in any 24 h windowSEKISHO_PAYER_KEY_FILE密钥Path to the payer private key file (mode 600). Never put the key itself in config.本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。
工具
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
@zero-two-labs/sekisho-mcp
一个本地 MCP 服务,让 OpenCode、Claude Code、Codex 或任何 MCP 客户端使用付费 MCP 工具。它连接到一个使用 x402(Avalanche 上的 USDC)按次收费的远程 MCP 服务,向你的 Agent 展示其工具,并从你的钱包为付费工具付款,且绝不会超过你设置的上限。
- 单次调用上限(
SEKISHO_MAX_PER_CALL,默认为 0.01 USDC):费用更高的工具会被拒绝,不会签署任何交易。 - 24 小时上限(
SEKISHO_MAX_PER_DAY,默认为 0.10 USDC):记录保存在磁盘文件中,因此重启或切换会话后仍然有效。 - 密钥绝不会写入编辑器配置。 密钥从私有文件(
chmod 600)读取;如果其他用户可读取该文件,代理就会拒绝使用。 - 工具描述中会显示价格。 首次调用后,Agent 就能看到每个工具的费用(以及费用是否超过你的上限),从而决定是否再次付费。
- 额外提供免费的工具
sekisho_wallet:可查看付款地址、网络、上限以及过去 24 小时的支出。
适用于 Avalanche 上任何使用 x402 exact 的 MCP 服务,而不仅限于 Sekisho 卖家。可通过它使用的付费服务列于 sekisho.zerotwolabs.xyz/services。已在 MCP Registry 中登记,名称为 io.github.usainbluntmx/sekisho-mcp。
1. 付款密钥
仅将一个钱包用于此用途,并存入少量 USDC。无需 AVAX:Gas 由卖家支付。
mkdir -p ~/.config/sekisho && chmod 700 ~/.config/sekisho
read -s KEY && printf '%s\n' "$KEY" > ~/.config/sekisho/payer.key && chmod 600 ~/.config/sekisho/payer.key && unset KEY
2. OpenCode
根据 OpenCode MCP 文档,在 opencode.json(项目根目录)或 ~/.config/opencode/opencode.json(全局)中配置:
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"sekisho": {
"type": "local",
"command": ["npx", "-y", "@zero-two-labs/sekisho-mcp"],
"enabled": true,
"environment": {
"SEKISHO_MCP_URL": "https://sekisho-api.zerotwolabs.xyz/mcp",
"SEKISHO_NETWORK": "avalanche",
"SEKISHO_MAX_PER_CALL": "0.01",
"SEKISHO_MAX_PER_DAY": "0.50"
},
"timeout": 60000
}
}
}
其他客户端:注册一个本地(stdio)MCP 服务,并使用相同的环境变量运行 npx -y @zero-two-labs/sekisho-mcp。
配置
| 变量 | 默认值 | 含义 |
|---|---|---|
SEKISHO_MCP_URL | (必填) | 付费远程 MCP 服务(Streamable HTTP)。仅支持 https,或 localhost 上的 http |
SEKISHO_NETWORK | avalancheFuji | avalancheFuji(测试网)或 avalanche(主网,真实 USDC) |
SEKISHO_MAX_PER_CALL | 0.01 | 每次工具调用的 USDC 上限 |
SEKISHO_MAX_PER_DAY | 0.10 | 任意 24 小时窗口内的 USDC 上限 |
SEKISHO_PAYER_KEY_FILE | ~/.config/sekisho/payer.key | 私钥文件(0x + 64 位十六进制字符,权限模式为 600) |
SEKISHO_LEDGER_FILE | ~/.config/sekisho/spend.json | 24 小时上限所用的支出日志 |
Agent 会自行决定调用付费工具,而不仅仅是在你提出要求时才调用:请将上限设低。即使服务随后未能结算,已签署的付款仍会计入上限。日志输出到 stderr;stdout 用于 MCP 协议。
MIT · Zero Two Labs 出品的 Sekisho
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。