Zbd MCP Server

🚀 ZBD MCP サーバー（非推奨、代わりに使用：https://github.com/zebedeeio/zbd-payments-typescript-sdk/tree/main/packages/mcp-server）

大規模言語モデル（LLM）にビットコイン機能を追加します。

🚀 クイックスタート

この MCP サーバーを使用することで、大規模言語モデル（LLM）にビットコイン機能を追加できます。以下の手順に従ってセットアップしてください。

✨ 主な機能

• 大規模言語モデル（LLM）にビットコイン機能を追加
• 様々なビットコイン関連の操作をサポート（支払い、請求書作成、クーポン管理など）

📦 インストール

前提条件

• Node.js 23+（または Bun/Deno/.ts ファイルを実行できる任意の環境）
• Bun（実行可能ファイルのビルドに使用）
• 支払い処理用の ZBD API キー

ZBD の設定

ZBD 開発者コンソールから API キーを取得し、プロジェクトのルートディレクトリに新しい .env ファイルを作成して、ZBD_API_KEY=XXXXXXXXXXXX の形式で追加してください（.env.example を参考にしてください）。

設定が完了したら、pnpm build コマンドを実行し、クライアント（Claude Desktop や Cursor など）で MCP サーバーを設定します。

Bun のインストール

Bun がインストールされていない場合は、以下の方法のいずれかを使用してインストールしてください。

macOS と Linux

# curl を使用する（推奨）
curl -fsSL https://bun.sh/install | bash

# Homebrew を使用する
brew install oven-sh/bun/bun

# npm を使用する
npm install -g bun

Windows

# PowerShell を使用する
powershell -c "irm bun.sh/install.ps1|iex"

# npm を使用する
npm install -g bun

# Scoop を使用する
scoop install bun

インストールを確認するには、以下のコマンドを実行します。

bun --version

プロジェクトのインストール

pnpm install

💻 使用例

環境の初期化

1. .env ファイルを作成し、ZBD_API_KEY を追加します。
2. 依存関係をインストールします：pnpm install

サーバーの起動

pnpm dev

サーバーの停止

Ctrl + C

📚 ドキュメント

サポートされる機能

以下は、MCP サーバーがサポートするすべての機能のリストです。

1. ライトニングネットワーク支払いの送信 - 1 つまたは複数の Lightning アドレスにビットコインを送信します。
2. バッチライトニングネットワーク支払いの送信 - 単一のリクエストで複数の Lightning アドレスにビットコインを送信します。
3. 請求書の作成 - 新しい Bitcoin Lightning Network 請求書を作成します。
4. 請求書の取得 - 単一の請求書に関するすべてのデータを取得します。
5. 請求書のデコード - 請求書の QR コードの内部属性を確認します。
6. 支払いの送信 - Bitcoin Lightning Network 支払いを送信します。
7. 支払いの取得 - 単一の支払いに関するすべてのデータを取得します。
8. 送金リクエストの作成 - ビットコイン引き出し用の QR コードを作成します。
9. 送金リクエストの取得 - 単一の引き出しリクエストに関するすべてのデータを取得します。
10. 送金リクエストの取り消し - 有効な引き出しリクエストを取り消し、資金をプロジェクトウォレットに返します。
11. 電子メール支払いの送信 - 任意の電子メールアドレスに即時ビットコイン支払いを送信します。
12. クーポンの作成 - 任意の ZBD ユーザーが使用できる一度限りの ZBD クーポンを作成します。
13. クーポンの取得 - 単一のクーポンに関するすべてのデータを取得します。
14. クーポンの交換 - ZBD クーポンを交換して、プロジェクトウォレットのポイントを取得します。
15. 内部送金 - 2 つのプロジェクト間で資金を移動します。
16. サポート地域の確認 - ユーザーがサポートされている地域からのものかどうかを確認します。
17. ZBD IP アドレスの取得 - ZBD サーバーの公式 IP アドレスを取得します。
18. 引き出しリクエストの作成 - ビットコイン引き出し用の QR コードを作成します。
19. 内部送金 - 2 つのプロジェクト間で資金を移動します。
20. クーポンの作成 - 任意の ZBD ユーザーが使用できる一度限りの ZBD クーポンを作成します。
21. クーポンの取得 - 単一のクーポンに関するすべてのデータを取得します。
22. クーポンの交換 - ZBD クーポンを交換して、プロジェクトウォレットのポイントを取得します。
23. revoke-voucher - 有効な引き出しリクエストを取り消し、資金をプロジェクトウォレットに返します。

トラブルシューティング

• ps aux | grep mcp-zbd | grep -v "grep" を使用してプロセスを確認します。
• lsof -i :3000 または他のポートを使用して、占有されているプロセスを見つけます。

プロジェクト構造

.
├── .env.example         # 環境変数のサンプルファイル
├── src                 # ソースコードディレクトリ
│   ├── index.ts        # エントリーファイル
│   └── utils           # ユーティリティ関数
└── package.json       # プロジェクトの依存関係と設定

🔧 技術詳細

この MCP サーバーは、公式の TypeScript SDK（https://github.com/modelcontextprotocol/typescript-sdk）を使用しています。

📄 注意事項

⚠️ 重要提示

すべての API リクエストには有効な ZBD_API_KEY が必要です。サーバーを安全な環境で実行し、API キーが漏洩しないようにしてください。