Grip MCP

为 Claude（或任何兼容 MCP 的智能体）提供一个在 Base 上的非托管 USDC 钱包 —— 且每笔支付都需人工确认。

简介

@grip-foundation/grip-mcp 是一个 Model Context Protocol 服务器，它向任何支持 MCP 的客户端（Claude Desktop、Claude Code、Continue 等）提供四个工具：

智能体在没有你的情况下绝不会动用资金。流程为：智能体暂存 → 你在对话中确认 → 智能体结算。不存在程序化的自动批准。

Related MCP server: clawpay-mcp

安装

选项 1 — 通过 npx（首次发布后）

在 ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) 或 %APPDATA%\Claude\claude_desktop_config.json (Windows) 中：

{
 "mcpServers": {
 "grip": {
 "command": "npx",
 "args": ["-y", "@grip-foundation/grip-mcp"]
 }
 }
}

选项 2 — 本地克隆

git clone https://github.com/grip-foundation/grip-mcp.git
cd grip-mcp
pnpm install
pnpm run build

然后将 Claude Desktop 指向构建后的文件：

{
 "mcpServers": {
 "grip": {
 "command": "node",
 "args": ["/absolute/path/to/grip-mcp/dist/server/index.js"]
 }
 }
}

编辑配置后请重启 Claude Desktop。

首次运行

服务器首次启动时，会生成一个新的 EOA 私钥并将其存储在 ~/.grip-mcp/agent-key（权限 0600）。此密钥控制智能账户。

在 Claude 中询问：

Show me my Grip wallet

Claude 将调用 grip_wallet 并回复你的智能账户地址、余额和限额。向该地址发送 Base 链上的 USDC 即可充值。

进行支付

充值后，向 Claude 询问类似以下内容：

Send 5 USDC to 0xba14744FfD57FA7d03b20D4c8BeDAaC301E865d1

Claude 将：

1. 调用 grip_create_payment 在链下暂存支付。

2. 向你展示详情（金额、收款人、备注）并请求确认。

3. 等待你的回复。

4. 如果你说“approve” → 调用 grip_settle_payment(token, "approve") → 在 Base 上执行。

5. 如果你说“no” → 调用 grip_settle_payment(token, "reject") → 不执行链上操作。

结算时会返回交易哈希和 Basescan 链接。

配置

安全模型

• 非托管。 Grip Foundation 不持有你的密钥、USDC 或任何支付记录。一切都在你的机器上运行。

• 托管支付中继（Paymaster），无需注册。 Gas 费通过路由至 Grip 托管代理的 Pimlico 支付中继以 USDC 支付。你无需拥有 Pimlico 账户。

• 人工确认由协议而非模型强制执行。 grip_create_payment 仅进行暂存。grip_settle_payment 是一个独立的工具调用。大多数 MCP 客户端（包括 Claude Desktop）在执行工具调用前都会提示人工确认 —— 这是第二层防护。

• 限额由服务器端强制执行。 即使模型尝试进行超过单笔或每日限额的支付，服务器也会拒绝暂存。

架构

Claude Desktop
 │ MCP (stdio)
 ▼
grip-mcp (this server)
 │ @grip-labs/sdk
 ▼
Grip-managed paymaster proxy → Pimlico bundler → Base mainnet
 ▲
 Coinbase Smart Wallet
 (your smart account)

该智能账户是 Base 上的 Coinbase Smart Wallet (ERC-4337)。新钱包的首次支付会运行一次性的引导 UserOp，用于部署账户并批准支付中继进行 USDC 报销；后续的 UserOp 则直接由 USDC 支付。

已知问题

首次支付可能需要重试。 在 @grip-labs/sdk@0.4 中，引导 UserOp（部署 + 批准支付中继）和实际转账 UserOp 是作为两个独立操作提交的。存在一个小的竞争窗口，即 viem 的内部 getFactoryArgs() 在引导程序于 Pimlico 捆绑器结算后，从公共 RPC 读取到过时的 getCode —— 随后 viem 在第二个 UserOp 中包含了 initCode，导致捆绑器报错 AA10 sender already constructed。

如果你的首次支付因该错误失败，只需让智能体重试即可。重试会成功，因为此时链上状态已经同步。同一钱包的后续支付是正常的 —— 每个钱包最多只运行一次引导程序。

@grip-labs/sdk@0.5 即将发布修复程序，它通过 executeBatch 将引导程序 + 首次转账合并为一个受赞助的 UserOp，从根本上消除了竞争，并节省了约 30% 的首次支付 Gas 费。grip-mcp 将在 0.1.1 版本中采用该修复。

许可证

MIT

构建者

Grip Foundation · 为 AI 智能体提供开放身份 + 支付轨道。

Maintenance

Resources

• NPM Package
• GitHub Repository
Need Help?Related Servers

Tools

• grip_create_paymentA
• grip_list_paymentsA
• grip_settle_paymentA
• grip_walletA