WalletTriage

wallettriage-mcp

适用于 WalletTriage 的 MCP 服务——面向 AI Agent 的 EVM 钱包实时漏洞暴露检查。每次查询都通过 x402 付费（使用 Base 上的 USDC），并由会话密钥在本地签名：无需注册、无需 API 密钥、无需提示词。无状态——不会持久保存任何关于你或查询的信息。

工具

• check_address_risk（付费）——实时评估 EVM 地址的风险：检查危险的 ERC20 授权，并与正在遭受攻击的合约实时威胁源交叉比对。返回 risk_score（0–100）、risk_level 和可采取行动的 findings。
• get_pricing（免费）——服务状态和当前每次查询的价格。

设置（Claude Desktop、Claude Code、Cursor）

需要 Node 20+。将以下内容添加到 MCP 配置中（例如 claude_desktop_config.json）：

{
  "mcpServers": {
    "wallettriage": {
      "command": "npx",
      "args": ["-y", "wallettriage-mcp"],
      "env": {
        "GATEWAY_URL": "https://api.wallettriage.com",
        "EVM_PRIVATE_KEY": "0xREPLACE_WITH_SESSION_WALLET_PRIVATE_KEY",
        "MAX_PAYMENT_ATOMIC": "100000"
      }
    }
  }
}

为会话钱包充值少量 Base 上的 USDC。**请使用余额较低的专用钱包，绝不要使用主密钥。**该钱包仅用于签署免 Gas 的 EIP-3009 USDC 付款；WalletTriage 不会持有或转移资金。

EVM_PRIVATE_KEY 是钱包的私钥（0x + 64 位十六进制字符），不是钱包地址。无需 ETH——付款免 Gas（EIP-3009）。充值前，请先使用免费的 get_pricing 工具测试连接。

然后向 Agent 提问：“在我与 0xd8dA… 交互之前，检查一下它的风险。”

故障排除

• unable to verify the first certificate（Windows / 企业网络中很常见）：你的防病毒软件或代理会拦截 TLS，而 Node 默认不使用系统证书存储。请在 env 块中添加 "NODE_OPTIONS": "--use-system-ca"。切勿禁用 TLS 验证——付款信息通过标头传输，必须防止被篡改。
• EVM_PRIVATE_KEY is malformed：该值必须为 0x + 64 位十六进制字符（会话钱包的私钥）。检查是否包含占位文本、缺少 0x 或有多余空格。
• Gateway unreachable：GATEWAY_URL 默认为 https://api.wallettriage.com。如果你覆盖了该值（例如指向本地网关），请确保主机可访问且服务正在运行。

环境变量

变量	必填	默认值	用途
EVM_PRIVATE_KEY	是	—	用于签署 x402 付款的会话密钥（Base 上的 USDC）
GATEWAY_URL	否	https://api.wallettriage.com	WalletTriage API 基础 URL。默认为生产环境；本地开发时设为 http://localhost:4021（非本地主机强制使用 HTTPS）
MAX_PAYMENT_ATOMIC	否	100000（US$0.10）	拒绝任何超过此上限的 402 付款要求（USDC 原子单位，6 位小数）
DEFAULT_SCAN_CHAIN	否	eth	默认链：eth、base、polygon、arbitrum、optimism、bsc

本地开发

npm install
cp .env.example .env   # set EVM_PRIVATE_KEY
npm start              # runs src/server.ts via tsx (stdio)

将 GATEWAY_URL 指向本地网关（GATEWAY_URL=http://localhost:4021），或使用 MCP Inspector 测试：

npx @modelcontextprotocol/inspector npx tsx src/server.ts

npm run build 会生成 dist/server.js（发布的 bin）。