⚠️ 廃止のお知らせ
🚨 この 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
Related MCP server: BSC MCP Server
前提条件
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実際のツール実装を提供します
利用可能なツール
ZBD (
src/zbd.ts): グローバル Bitcoin Lightning 支払い用の ZBD API
新しいツールの作成
新しいツールを作成するには:
srcディレクトリに新しいTypeScriptファイルを作成します（例：src/mytool.ts）既存のツールをテンプレートとして使用する
package.jsonにビルド スクリプトを追加します。
新しいツールを含めるように
build:allスクリプトを更新します
使用法
実行可能ファイルのビルド
結果として得られる実行ファイルはbinディレクトリに保存され、直接実行できます。
カーソルノート
カーソルでこれらのツールを使用する場合は、常に実行可能ファイルへのフルパスを使用します。
あるいは、Node を使用して TypeScript ファイルを直接実行することもできます。
テスト
利用可能なZBD.tsツール
ZBD MCP サーバーでは次のツールが利用できます。
send-lightning-payment- ZBD を使用して Lightning アドレスに Bitcoin Lightning Network 支払いを送信するsend-gamertag-payment- ZBD ゲーマータグにビットコイン支払いを送信するcreate-gamertag-charge- ZBD ユーザーの支払いリクエストを生成するvalidate-lightning-address- Lightning アドレスの有効性を検証するcreate-lightning-charge- Lightning アドレスの支払いリクエストを生成するget-userid-by-gamertag- ZBD ゲーマータグからユーザー ID を取得するget-gamertag-by-userid- ユーザーIDからZBDゲーマータグを取得するsend-email-payment- 任意のメールアドレスにビットコインの即時支払いを送信しますget-wallet-info- ZBDプロジェクトのウォレットに関するすべてのデータを取得しますcheck-supported-region- ユーザーがサポートされている地域から来ているかどうかを確認するget-zbd-ip-addresses- ZBDサーバーの公式IPアドレスを取得しますinternal-transfer- 2つのプロジェクト間で資金の移動を実行しますcreate-withdrawal-request- ビットコイン出金QRコードを作成するget-withdrawal-request- 単一の出金リクエストに関するすべてのデータを取得しますsend-payment- Bitcoin Lightning Network 支払いを送信するget-payment- 単一の支払いに関するすべてのデータを取得するdecode-charge- Charge QRコードの内部特性を理解するcreate-charge- 新しいBitcoin Lightning Networkのチャージを作成するget-charge- 単一のチャージに関するすべてのデータを取得するcreate-voucher- すべての ZBD ユーザーが利用できる 1 回限りの ZBD バウチャーを作成しますget-voucher- ZBDバウチャーの詳細を取得するredeem-voucher- ZBDバウチャーを交換してプロジェクトウォレットに入金しますrevoke-voucher- 有効な ZBD バウチャーを取り消して、プロジェクト ウォレットに sats を返却しますsend-batch-lightning-payments- 1回のリクエストで複数のBitcoin Lightning Network支払いをLightningアドレスに送信する