MCP Money

MCP Money

使用 NDK（Nostr Development Kit）实现的 Nostr MCP（Model Context Protocol）钱包，支持 Cashu ecash 功能。

功能

• Cashu 钱包集成：全面支持 Cashu ecash 铸币厂和代币
• Lightning Network：通过 Lightning 发票存款并支付 Lightning 发票
• Nostr Zaps：使用 npub 或 NIP-05 标识符向用户发送 zap
• 多铸币厂支持：同时管理多个 Cashu 铸币厂
• 持久化存储：将钱包状态保存到本地文件，并缓存铸币厂信息
• MCP 服务：通过 Model Context Protocol 提供钱包功能
• CLI 界面：直接通过命令行执行所有钱包操作

安装

npm install mcp-money

使用

MCP 服务模式（默认）

不带参数运行即可启动 MCP 服务：

npx mcp-money

CLI 模式

使用特定命令直接执行钱包操作：

# Get total balance
npx mcp-money get_balance

# Get balance per mint
npx mcp-money get_mint_balances

# Create deposit invoice
npx mcp-money deposit 1000 https://testnut.cashu.space

# Pay lightning invoice
npx mcp-money pay lnbc1...

# Send a zap
npx mcp-money zap npub1... 100 "Great post!"

# Add a new mint
npx mcp-money add_mint https://mint.example.com

身份验证

钱包支持通过多种方式提供 Nostr 私钥：

1. 命令行：--nsec nsec1...
2. 环境变量：NSEC=nsec1...
3. 配置文件：自动保存到 .wallet.json
4. 自动生成：如果未提供密钥，则创建新密钥

MCP 工具

作为 MCP 服务运行时，可使用以下工具：

• get_balance：获取钱包总余额
• get_mint_balances：按铸币厂查看余额明细
• deposit：为指定金额和铸币厂创建存款发票
• pay：支付 Lightning 发票
• zap：向用户发送 zap
• add_mint：向钱包添加铸币厂

与 AI 助手集成

Claude Code 集成

如需将此钱包与 Claude Code 搭配使用，请将其添加到项目的 MCP 配置中：

{
  "mcpServers": {
    "mcp-money": {
      "command": "npx",
      "args": ["mcp-money"]
    }
  }
}

也可以全局安装并直接引用二进制文件：

npm install -g mcp-money

{
  "mcpServers": {
    "mcp-money": {
      "command": "mcp-money"
    }
  }
}

Goose 集成

如需将此钱包与 Goose 搭配使用，请将其添加到 ~/.config/goose/config.yaml：

如果你有想要使用的 nsec，可以通过传入 --nsec nsec1... 来设置。

extensions:
  money:
    args:
    - -y
    - mcp-money
    bundled: null
    cmd: npx
    description: Money for agents
    enabled: true
    env_keys: []
    envs: {}
    name: money
    timeout: 300
    type: stdio

添加配置后，重启 AI 助手即可开始使用钱包工具。

配置

钱包会自动创建 .wallet.json 文件，用于存储：

• 私钥（nsec）
• 公钥（npub）
• 已配置的中继
• 已配置的铸币厂
• 缓存的铸币厂信息

架构

基于以下组件构建：

• NDK：用于 Nostr 协议交互的 Nostr Development Kit
• NDK Wallet：Cashu 钱包实现
• Nostr Tools：底层 Nostr 工具
• Bun：快速的 JavaScript 运行时和包管理器

安全

• 私钥本地存储在 .wallet.json 中
• 缓存铸币厂信息以提升性能
• 所有 Nostr 通信均使用标准 NIP 协议
• Lightning 支付需要明确确认

许可证

MIT

贡献

1. Fork 此仓库
2. 创建功能分支
3. 进行更改
4. 如适用，添加测试
5. 提交拉取请求

支持

如有问题或疑问，请在 GitHub 仓库中提交 issue。