ZBD MCP サーバー

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

# 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実際のツール実装を提供します

利用可能なツール

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

新しいツールの作成

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

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

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

新しいツールを含めるように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 サーバーでは次のツールが利用できます。

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アドレスに送信する

ZBD MCP Server

Integrations