MCP Money

MCP货币

使用NDK（Nost开发工具包）和Cashu ecash功能为Nost实现MCP（模型上下文协议）货币。

特性

• Cashu钱包集成：完全支持Cashu ecash造币厂和代币
• 闪电网络：通过Lightning发票存款并支付Lightning发票
• 我们的Zaps：使用npub或NIP-05标识符向用户发送zap
• 多薄荷支持：同时管理多个Cashu造币厂
• 永久存储：使用薄荷信息缓存将钱包状态保存到本地文件
• MCP服务器：通过模型上下文协议公开钱包功能
• CLI接口：直接使用命令行进行所有钱包操作

安装

npm install mcp-money

用法

MCP服务器模式（默认）

无参数运行以启动MCP服务器：

npx mcp-money

命令行接口命令模式

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

# 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：支付闪电发票
• zap：向用户发送zap
• add_mint：在钱包里加一枚薄荷糖

与AI助手集成

Claude代码集成

使用此钱包 克劳德代码，将其添加到项目的MCP配置中：

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

或者全局安装并直接引用二进制文件：

npm install -g mcp-money

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

鹅集成

使用此钱包 鹅，将其添加到您的 ~/.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开发工具包
• NDK 钱包：Cashu钱包实现
• 我们的工具：低级Nostr实用程序
• 包子：快速JavaScript运行时和包管理器

安全

• 私钥存储在本地 .wallet.json
• Mint信息被缓存以提高性能
• 所有Nostr通信都使用标准NIP协议
• 闪电支付需要明确确认

许可证

麻省理工学院

贡献

1. 分叉存储库
2. 创建要素分支
3. 进行更改
4. 如果适用，添加测试
5. 提交拉取请求

支持

有关问题和疑问，请在GitHub存储库上打开问题。