MCP Money

MCP Money

NDK（Nostr Development Kit）とCashuの電子現金機能を使用した、Nostr向けのMCP（Model Context Protocol）マネー実装です。

特長

• Cashuウォレット統合：Cashuの電子現金ミントとトークンを全面的にサポートします
• Lightning Network：Lightningインボイスによる入金と、Lightningインボイスの支払いに対応します
• Nostr Zaps：npubまたはNIP-05識別子を使って、ユーザーにzapsを送信します
• 複数ミントのサポート：複数の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. リポジトリをフォークします
2. 機能ブランチを作成します
3. 変更を加えます
4. 該当する場合はテストを追加します
5. プルリクエストを送信します

サポート

問題や質問がある場合は、GitHubリポジトリでissueを作成してください。