agent-wallet-mcp

AgentWallet MCP

你的 Agent 可以维护自己的沙盒化支出账本，为自己设置每月预算上限，向其他 Agent 转账，并生成正式发票——整个过程无需接触你的金融账户。

钱包是一个本地数字账本（存储在 ~/.agentwallet/ 中）。它不连接任何银行、支付处理商或区块链。你可以用它在自己的基础设施中模拟 Agent 间的账务处理和支出限额。

你的 Agent 可以做什么

• 为任意 Agent ID 创建钱包，并为其注入初始余额
• 随时查看当前余额、每月支出总额和待处理交易
• 向任意钱包存款和取款，取款时会自动执行预算限制
• 在两个 Agent 钱包之间以单次原子操作转账，并记录双方账目
• 设置严格的每月支出上限：超出上限的取款和转账会在调用时被拒绝
• 生成带编号的发票记录（INV-000001 等），用于 Agent 间的服务结算

安装

要求： Python 3.10+、mcp package。

pip install mcp

Claude Desktop — 添加到 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "agent-wallet": {
      "command": "python",
      "args": ["/absolute/path/to/agent-wallet-mcp/server.py"]
    }
  }
}

Cursor — 添加到项目根目录中的 .cursor/mcp.json：

{
  "mcpServers": {
    "agent-wallet": {
      "command": "python",
      "args": ["/absolute/path/to/agent-wallet-mcp/server.py"]
    }
  }
}

工具参考

工具	描述	关键参数
wallet_create	为 Agent 创建新钱包	agent_id（必填）、initial_balance（默认值：0）
wallet_balance	获取余额、支出总额、每月预算和待处理数量	agent_id
wallet_deposit	向钱包存入资金	agent_id、amount、source
wallet_withdraw	提取资金；如果会超出每月预算则拒绝	agent_id、amount、destination
wallet_transfer	在两个钱包间原子转账；遵守来源钱包的预算	from_agent_id、to_agent_id、amount、reason
wallet_transactions	最近的交易记录，按时间从新到旧排列	agent_id、limit（默认值：20）
wallet_set_budget	设置或移除每月支出上限（0 = 无限制）	agent_id、monthly_budget
wallet_invoice	生成两个 Agent 之间的带编号发票记录	from_agent_id、to_agent_id、amount、description

数据存储

~/.agentwallet/
├── wallets/
│   └── <agent_id>.json        # balance, budget, total_spent
├── transactions/
│   └── <agent_id>.json        # full transaction history
├── invoices/
│   └── INV-000001.json        # invoice records
└── _invoice_counter.json      # auto-incrementing invoice number

预算执行

当 monthly_budget > 0 时，如果 total_spent + amount > monthly_budget，服务会拒绝任何取款或转账。余额修改前会同步执行检查。将 monthly_budget 设为 0 即可移除限制。

定价

套餐	价格	包含内容
Pro	$19/月	钱包、交易和发票均不限量

通过 Stripe 订阅

许可证

专有——请参阅订阅条款。源代码：github.com/Rumblingb/agent-wallet-mcp