ZBD MCP Server

⚠️ 廃止のお知らせ

🚨 この MCP サーバーはメンテナンスされなくなりました。🚨

新しく改良されたMCPサーバー実装に移行しました。今後のアップデート、機能、サポートはすべてそちらで提供されます。

👉 こちらから新しい MCP サーバーに移行してください: https://github.com/zebedeeio/zbd-payments-typescript-sdk/tree/main/packages/mcp-server

このリポジトリは参照用に引き続き利用できますが、本番環境での使用は推奨されません。

ZBD MCP サーバー (非推奨 - 代わりにこちらを使用してください: https://github.com/zebedeeio/zbd-payments-typescript-sdk/tree/main/packages/mcp-server )

LLM にビットコインの力を加えましょう。

ベースSDK

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

前提条件

• Node.js 23+ (または Bun/Deno/.ts ファイルの実行をサポートするもの)
• Bun（実行ファイルの構築用）
• 支払い処理用のZBD APIキー

ZBDセットアップ

ZBD 開発者ダッシュボードから API キーを取得し、 ZBD_API_KEY=XXXXXXXXXXXXの下の新しい.envファイルに配置します (例については.env.exampleを確認してください)。

完了したら、 pnpm buildコマンドを実行し、クライアント (Claude Desktop または Cursor など) に MCP サーバーをセットアップします。

Bunのインストール

Bun がインストールされていない場合は、次のいずれかの方法でインストールできます。

macOSとLinux

ウィンドウズ

次を実行してインストールを確認します。

インストール

トラブルシューティング

• 実行中のすべての ZBD MCP サーバー インスタンスを一覧表示するにはps aux | grep mcp-zbd | grep -v grepを使用します。
• pkill -f mcp-zbdを使用して、残っている可能性のある重複した ZBD MCP サーバー インスタンスをすべて強制終了します。

プロジェクト構造

このプロジェクトは、MCP ツールを構築するためのモジュール式のアプローチを示しています。

• 各ツールは、 srcディレクトリ内の独自のTypeScriptファイルで定義されます。
• 各ツールは、 binディレクトリ内のスタンドアロン実行ファイルに組み込むことができます。
• メインのindex.ts実際のツール実装を提供します

利用可能なツール

1. ZBD ( src/zbd.ts ): グローバル Bitcoin Lightning 支払い用の ZBD API

新しいツールの作成

新しいツールを作成するには:

1. srcディレクトリに新しいTypeScriptファイルを作成します（例： src/mytool.ts ）
2. 既存のツールをテンプレートとして使用する
3. package.jsonにビルド スクリプトを追加します。

4. 新しいツールを含めるようにbuild:allスクリプトを更新します

使用法

実行可能ファイルのビルド

結果として得られる実行ファイルはbinディレクトリに保存され、直接実行できます。

カーソルノート

カーソルでこれらのツールを使用する場合は、常に実行可能ファイルへのフルパスを使用します。

あるいは、Node を使用して TypeScript ファイルを直接実行することもできます。

テスト

利用可能なZBD.tsツール

ZBD MCP サーバーでは次のツールが利用できます。

1. send-lightning-payment - ZBD を使用して Lightning アドレスに Bitcoin Lightning Network 支払いを送信する
2. send-gamertag-payment - ZBD ゲーマータグにビットコイン支払いを送信する
3. create-gamertag-charge - ZBD ユーザーの支払いリクエストを生成する
4. validate-lightning-address - Lightning アドレスの有効性を検証する
5. create-lightning-charge - Lightning アドレスの支払いリクエストを生成する
6. get-userid-by-gamertag - ZBD ゲーマータグからユーザー ID を取得する
7. get-gamertag-by-userid - ユーザーIDからZBDゲーマータグを取得する
8. send-email-payment - 任意のメールアドレスにビットコインの即時支払いを送信します
9. get-wallet-info - ZBDプロジェクトのウォレットに関するすべてのデータを取得します
10. check-supported-region - ユーザーがサポートされている地域から来ているかどうかを確認する
11. get-zbd-ip-addresses - ZBDサーバーの公式IPアドレスを取得します
12. internal-transfer - 2つのプロジェクト間で資金の移動を実行します
13. create-withdrawal-request - ビットコイン出金QRコードを作成する
14. get-withdrawal-request - 単一の出金リクエストに関するすべてのデータを取得します
15. send-payment - Bitcoin Lightning Network 支払いを送信する
16. get-payment - 単一の支払いに関するすべてのデータを取得する
17. decode-charge - Charge QRコードの内部特性を理解する
18. create-charge - 新しいBitcoin Lightning Networkのチャージを作成する
19. get-charge - 単一のチャージに関するすべてのデータを取得する
20. create-voucher - すべての ZBD ユーザーが利用できる 1 回限りの ZBD バウチャーを作成します
21. get-voucher - ZBDバウチャーの詳細を取得する
22. redeem-voucher - ZBDバウチャーを交換してプロジェクトウォレットに入金します
23. revoke-voucher - 有効な ZBD バウチャーを取り消して、プロジェクト ウォレットに sats を返却します
24. send-batch-lightning-payments - 1回のリクエストで複数のBitcoin Lightning Network支払いをLightningアドレスに送信する