⚠️ 廃止のお知らせ

🚨 この 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: Alby Bitcoin Payments 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

# Using curl (recommended)
curl -fsSL https://bun.sh/install | bash

# Using Homebrew
brew install oven-sh/bun/bun

# Using npm
npm install -g bun

ウィンドウズ

# Using PowerShell
powershell -c "irm bun.sh/install.ps1|iex"

# Using npm
npm install -g bun

# Using Scoop
scoop install bun

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

bun --version

インストール

pnpm install

トラブルシューティング

• 実行中のすべての 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にビルド スクリプトを追加します。

"build:mytool": "mkdir -p bin && bun build src/mytool.ts --compile --minify --sourcemap --outfile bin/mcp-mytool"

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

使用法

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

# Build all tools
pnpm build

# Build a specific tool
pnpm build:zbd

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

./bin/mcp-zbd

カーソルノート

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

/path/to/your/project/bin/mcp-zbd

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

/path/to/node ~/path/to/project/src/index.ts

テスト

# Run all tests
pnpm test

# Run tests in watch mode
pnpm test:watch

# Run tests with coverage
pnpm test:coverage

利用可能な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アドレスに送信する