Bitcoin SV MCP サーバー
⚠️ 注意: 実験作業進行中
このプロジェクトはまだ初期段階の実験段階です。機能は変更される可能性があり、APIはまだ安定していません。貢献、フィードバック、バグ報告を歓迎します!お気軽に問題を報告したり、プルリクエストを送信してください。
モデルコンテキストプロトコル(MCP)フレームワーク用のBitcoin SV(BSV)ツールのコレクション。このライブラリは、BSVブロックチェーンとの連携に必要なウォレット、序数、ユーティリティ関数を提供します。
インストールとセットアップ
パンを使用する(オプションですが推奨)
このプロジェクトは、高速なJavaScriptランタイム兼パッケージマネージャーであるBunを使用して構築されています。最高のパフォーマンスを得るにはBunの使用が推奨されますが、BunはNode.jsとの下位互換性を持つように設計されているため、サーバーはNode.jsとnpmでも実行できます。
Bunのインストール
macOS (Homebrew を使用):
macOS/Linux/WSL (インストーラー スクリプトを使用):
Windows: Windows ユーザーは、Bun を実行するために WSL (Windows Subsystem for Linux) または Docker を使用する必要があります。
Node.js と npm も動作しますが、同じパフォーマンス上の利点が得られない可能性があります。
Related MCP server: MCP Blockchain Query Server
MCPクライアントへの接続
このサーバーはモデルコンテキストプロトコル(MCP)を実装しており、AIアシスタントがBitcoin SVの機能を利用できるようにします。このサーバーは、MCP対応の様々なクライアントに接続できます。

注:
PRIVATE_KEY_WIF環境変数はオプションになりました。この環境変数を指定しないと、サーバーは教育リソースとウォレット以外のツールが利用可能な制限モードで動作します。ウォレットとMNEEトークンの操作には有効な秘密鍵が必要です。また、IDENTITY_KEY_WIF環境変数を設定することで、認証、キュレーション、信頼の輪のための序数表記のシグマプロトコル署名を有効にすることもできます。
カーソル
Cursorで BSV MCP サーバーを使用するには:
まだインストールしていない場合は、Cursorをインストールしてください。
カーソルを開き、設定→拡張機能→モデルコンテキストプロトコルに移動します。
「新しいグローバルMCPサーバーを追加」をクリックします
次の構成を JSON 形式で入力します。
<your_private_key_wif>を実際の秘密鍵 WIF に置き換えてください(安全な場所に保管してください!)。WIF をお持ちでない場合は、今のところ省略できますが、ウォレットを必要とするツールは使用できなくなります。<your_identity_key_wif>もオプションです。これは、提供された ID キーを使用して、Sigma プロトコルで 1Sat Ordinals に署名します。「保存」をクリック
BSV ツールは、「Bitcoin SV」名前空間の Cursor の AI アシスタントで利用できるようになります。
npmユーザー向けの代替手段
Bun の代わりに npm を使用する場合:
デスクトップ版クロード
このサーバーをClaude for Desktopに接続するには:
Claude for Desktopを開き、Claude > 設定 > 開発者に移動します。
「設定の編集」をクリックします。
Claude の設定 JSON ファイルを、お好きなテキストエディタで開きます。CLI から実行する場合は、以下の手順を実行してください。
BSV MCP サーバーを設定に追加します。
{ "mcpServers": { "Bitcoin SV": { "command": "bun", "args": [ "run", "bsv-mcp@latest" ], "env": { "PRIVATE_KEY_WIF": "<your_private_key_wif>", "IDENTITY_KEY_WIF": "<your_identity_key_wif>" } } } }<your_private_key_wif>を実際の秘密鍵 WIF に置き換えます。ファイルを保存し、Claude for Desktopを再起動します。
Claude for Desktopのツールアイコン(ハンマー)をクリックするとBSVツールが表示されます。
npm ユーザー向けの代替手段 (Claude)
Bun の代わりに npm を使用する場合は、「command」フィールドを「npx」に置き換えます。
利用可能なツール
ツールキットはいくつかのカテゴリに分類されています。
ウォレットツール
ウォレットツールはBSVウォレットのコア機能を提供します。
ツール名 | 説明 | 出力例 |
| 指定されたプロトコルとキーIDの公開キーを取得します |
|
| 提供されたデータの暗号署名を作成する |
|
| 提供されたデータに対して暗号署名を検証する |
|
| ウォレットの暗号鍵を使用してデータを暗号化および復号化するための複合ツール。 例: 1. テキストを暗号化:
2. データを復号化:
| 暗号化:
復号化:
|
| 現在のウォレットのBSVアドレスまたは派生パスを返します |
|
| 指定されたアドレスにBSVを送信します(BSVまたはUSDの金額をサポート) |
|
| マーケットプレイスのリストからNFTまたはBSV-20/BSV-21トークンを購入する |
|
| BSVブロックチェーン上に序数を作成して刻み込む |
|
BSVツール
BSVブロックチェーンおよびネットワークとやり取りするためのツール:
ツール名 | 説明 | 出力例 |
| 取引所APIから現在のBSV価格を取得します |
|
| BSVトランザクションをデコードし、詳細情報を返します |
|
| WhatsOnChain APIエンドポイントにアクセスできる包括的なブロックチェーンエクスプローラーツール |
|
序数ツール
BSVで序数(NFT)を操作するためのツール:
ツール名 | 説明 | 出力例 |
| 特定の碑文に関する詳細情報を取得します |
|
| さまざまな基準に基づいて碑文を検索する |
|
| 統一されたインターフェースでNFT、BSV-20、BSV-21トークンの市場リストを取得します |
|
| BSV-20およびBSV-21トークンの市場販売に関する情報を取得します |
|
| IDで特定のBSV20トークンの詳細を取得します |
|
ユーティリティツール
汎用ユーティリティ関数:
ツール名 | 説明 | 出力例 |
| 異なるエンコード形式 (utf8、16 進数、base64、バイナリ) 間でデータを変換します。 パラメータ: -
(必須): 変換する文字列
(必須): ソースエンコード形式 (utf8、16 進数、base64、またはバイナリ) -
(必須): ターゲットエンコード形式 (utf8、16 進数、base64、またはバイナリ) 例: - UTF-8 から 16 進数:
→
- UTF-8 から base64:
→
- base64 から UTF-8:
→
- 16 進数から base64:
→
注: - すべてのパラメータは必須です - ツールは変換されたデータを文字列として返します - バイナリ変換の場合、データはバイト値の配列として表されます |
(UTF-8の「Hello World」をbase64に変換) |
MNEEツール
MNEE トークンを操作するためのツール:
ツール名 | 説明 | 出力例 |
| ウォレットの現在のMNEEトークン残高を取得します |
|
| MNEEトークンを指定のアドレスに送信します。MNEEとUSDの両方の金額をサポートします。 |
|
| MNEE取引を解析して、その操作と金額に関する詳細情報を取得します。金額はすべて小数点以下5桁の原子単位で表されます(例:1000原子単位 = 0.01 MNEE)。 |
|
MCP でのツールの使用
接続すると、AIアシスタントを介して自然言語でBitcoin SVと対話できるようになります。プロンプトの例を以下に示します。
ウォレット操作
「Bitcoin SVアドレスを取得する」
「0.01 BSVを1ExampleBsvAddressXXXXXXXXXXXXXXXXXXに送金する」
「1ExampleBsvAddressXXXXXXXXXXXXXXXXXXに5米ドル相当のBSVを送信してください」
「0.01 MNEEを1ExampleBsvAddressXXXXXXXXXXXXXXXXXXに送金する」
「MNEE残高を確認する」
「このMNEEトランザクションを解析する: txid」
「ウォレットのキーを使用してこのメッセージを暗号化する」
「以前暗号化されたこのデータを復号化してください」
「このNFTリストを購入: txid_vout」
「このBSV-20トークンリストを購入: txid_vout」
序数(NFT)
「アウトポイント6a89047af2cfac96da17d51ae8eb62c5f1d982be2bc4ba0d0cd2084b7ffed325_0のNFTに関する情報を表示してください」
「Pixel Zoide NFTを検索」
「BSV NFTの現在のマーケットプレイスリストを表示」
「ティッカーPEPEのBSV-20トークンリストを表示」
「最近のBSV-20トークンセール情報を入手」
ブロックチェーン運用
「現在のBSVの価格はいくらですか?」
「このBSVトランザクションをデコードします: (トランザクションの16進数またはID)」
「最新のビットコインSVチェーン情報を入手する」
「高さ800000のブロックの詳細を表示」
「アドレス 1ExampleBsvAddressXXXX の取引履歴を調べる」
「ウォレットアドレスの未使用出力(UTXO)を確認する」
「ハッシュ a1b2c3d4e5f6 のトランザクションの詳細を取得します...」
データ変換
「『Hello World』をUTF-8から16進形式に変換する」
MCP プロンプトとリソース
BSV MCPサーバーは、Bitcoin SVテクノロジーに関する詳細な情報とコンテキストを提供する専用のプロンプトとリソースを公開しています。AIモデルはこれらにアクセスすることで、理解度と能力を向上させることができます。
利用可能なプロンプト
サーバーは、MCP プロトコルを介して直接アクセスできる次の教育プロンプトを提供します。
序数プロンプト
識別子:
bitcoin_sv_ordinals説明: Bitcoin SV 序数に関する包括的な情報(それが何であるか、どのように機能するか、どのように使用するかなど)。
使用方法: この情報にアクセスするには、アシスタントに「Bitcoin SV ordinals」または「1Sat Ordinals」について尋ねます。
BSV SDK プロンプト
Bitcoin SV SDK に関する詳細情報を提供するプロンプトのコレクション:
概要
識別子:
bitcoin_sv_sdk_overview説明: Bitcoin SV SDK の目的と主なコンポーネントを含む概要。
使用方法:「BSV SDK について教えてください」または「Bitcoin SV SDK とは何ですか?」
ウォレット操作
識別子:
bitcoin_sv_sdk_wallet説明: BSV SDK でのウォレット操作に関する情報。
使用方法: 「BSV SDK ではウォレット操作はどのように機能しますか?」
取引の構築
識別子:
bitcoin_sv_sdk_transaction説明: トランザクションの作成と操作に関する詳細。
使用方法:「BSV SDK トランザクションの構築について説明します」または「BSV SDK を使用してトランザクションを作成するにはどうすればよいですか?」
認証
識別子:
bitcoin_sv_sdk_auth説明: BSV SDK の認証および ID プロトコル。
使用方法:「BSV SDK では認証はどのように機能しますか?」
暗号化
識別子:
bitcoin_sv_sdk_cryptography説明: 署名、暗号化、検証機能。
使用方法:「BSV SDK の暗号化機能の説明」
スクリプト
識別子:
bitcoin_sv_sdk_script説明: Bitcoin のスクリプトと契約機能。
使用方法: 「BSV SDK を使用して Bitcoin スクリプトを操作するにはどうすればよいですか?」
プリミティブ
識別子:
bitcoin_sv_sdk_primitives説明: BSV SDK のコア データ型と構造。
使用法:「BSV SDK ではどのようなプリミティブが利用できますか?」
利用可能なリソース
サーバーは、Bitcoin Request for Comments (BRC) の仕様とドキュメントへのアクセスも提供します。
変更ログリソース
識別子:
bsv-mcp-changelog説明: BSV MCP サーバーのバージョン履歴と変更ログ。
使用方法: 「BSV MCP の変更ログを表示してください」または「最新バージョンの新機能は何ですか?」
BRCリソース
BRCの概要
識別子:
brcs_readme説明: BRC リポジトリ内のすべての Bitcoin SV プロトコル仕様の概要。
使用方法: 「Bitcoin SV BRC の概要を表示」
BRCの概要
識別子:
brcs_summary説明: すべての Bitcoin SV BRC の目次。
使用方法:「Bitcoin SV BRCの概要を教えてください」
具体的なBRC仕様
識別子:
brc_spec説明: カテゴリと番号で特定の BRC 仕様にアクセスします。
使用法: 「取引エンベロープの BRC 8 を表示してください」または「BRC 1 は何を指定しますか?」
BRCカテゴリー
BRC 仕様は次のカテゴリに分類されます。
財布
取引
スクリプト
トークン
オーバーレイ
支払い
ピアツーピア
鍵導出
アウトポイント
意見
ステートマシン
アプリ
プロンプトとリソースの使用
AIモデルはこれらのプロンプトとリソースを使用して、Bitcoin SVテクノロジーに関するより正確で詳細な回答を提供できます。ユーザーは以下のことができます。
特定のトピックについて質問する:「Bitcoin SV のオーディナルについて教えてください」または「BSV SDK のトランザクション構築について説明してください」
具体的な BRC の詳細をリクエストします。「BRC 8 では何が規定されていますか?」または「トランザクション作成時の BRC を表示してください」
一般的な概要を確認する:「BSV SDK とは何ですか?」または「すべての BRC の概要を表示してください」
これらのプロンプトとリソースにより、AI の知識ベースが強化され、複雑な Bitcoin SV トピックに対しても、より技術的で正確な応答が可能になります。
MCPの仕組み
MCP 対応の AI アシスタントと対話する場合:
AIがあなたのリクエストを分析し、どのツールを使用するかを決定します
承認されると、適切なBSV MCPツールが呼び出されます。
サーバーはビットコインSVブロックチェーン上で要求された操作を実行する
結果はAIアシスタントに返されます
アシスタントは自然な会話形式で情報を提示します
カスタマイズオプション
BSV MCP サーバーは、環境変数を使用して特定のコンポーネントを有効または無効にすることでカスタマイズできます。
コンポーネント構成
環境変数 | デフォルト | 説明 |
|
| すべての教育プロンプトを無効にするには、
に設定します |
|
| すべてのリソース(BRC、変更ログ)を無効にするには、
に設定します。 |
|
| すべてのツールを無効にするには
に設定します |
ツール固有の構成
環境変数 | デフォルト | 説明 |
|
| Bitcoinウォレットツールを無効にするには
に設定します |
|
| MNEEトークンツールを無効にするには
に設定します |
|
| BSVブロックチェーンツールを無効にするには
に設定してください |
|
| 序数/NFTツールを無効にするには
に設定してください |
|
| ユーティリティツールを無効にするには
に設定します |
|
| 識別キー用のオプションの WIF。設定されている場合、序数の刻印は認証、キュレーション、および信頼の Web のためにシグマ プロトコルで署名されます。 |
|
|
に設定すると、トランザクションのブロードキャストが無効になります。代わりに、生のトランザクションの16進数を返します。ブロードキャスト前のテストやトランザクションの確認に役立ちます。 |
例
ツールを使わず、教育リソースとプロンプトのみで実行します。
ウォレットやその他の機能なしで、BSV ツールのみで実行します。
ウォレット操作以外のすべてのツールを使用します。
ブロードキャストせずにトランザクションを作成する (ドライラン モード):
トラブルシューティング
BSV MCP サーバーに問題がある場合:
接続の問題
システムにBunまたはNode.jsがインストールされていることを確認してください
WIF秘密鍵が環境に正しく設定されていることを確認します
クライアントがMCPをサポートし、適切に構成されていることを確認してください。
クライアントのコンソール出力でエラーメッセージを探します
Bunを最新の状態に保つ
互換性を確保するために、Bun を最新バージョンに更新しておくことが重要です。
現在の Bun バージョンを確認するには:
ログ記録とデバッグ
Claude for Desktop の場合は、次のログを確認してください。
カーソルの場合は、[設定] → [拡張機能] → [モデル コンテキスト プロトコル] でカーソル MCP ログを確認します。
最近の更新
トランザクションブロードキャスト制御: トランザクションがネットワークにブロードキャストされるのを防ぐための
DISABLE_BROADCASTING環境変数を追加しましたブロックチェーンエクスプローラー:メインネット/テストネットをサポートするWhatsOnChain APIアクセス用の
bsv_exploreツールを追加しました統合ツール:
wallet_encrypt/wallet_decrypt単一のwallet_encryptionツールに統合しました強化されたマーケットプレイス:出品、販売、購入におけるNFT、BSV-20/21トークンのサポート
パフォーマンス: 価格キャッシュの追加とAPIエンドポイント構造の最適化
検証の改善:秘密鍵とパラメータのエラー処理の改善
Bitcoin SV ブロックチェーンエクスプローラー
bsv_exploreツールは、WhatsOnChain APIを介してBitcoin SVブロックチェーンへの包括的なアクセスを提供します。この強力なエクスプローラーツールを使用すると、チェーンデータ、ブロック、トランザクション、アドレス情報など、ブロックチェーンのさまざまな側面を照会できます。
利用可能なエンドポイント
このツールは、次のエンドポイント カテゴリと特定のエンドポイントをサポートしています。
チェーンデータ
終点 | 説明 | 必須パラメータ | 回答例 |
| ネットワーク統計、難易度、チェーンワーク | なし |
|
| 高さや状態を含む現在のチェーンのヒント | なし |
|
| 現在のBSV流通供給量 | なし |
|
| 接続されたピアの統計 | なし |
|
ブロックデータ
終点 | 説明 | 必須パラメータ | 回答例 |
| ハッシュによるブロックデータの完全化 |
|
|
| 高さでブロックデータを完了する |
|
|
| 特定のブロックのタグ数の統計 |
|
|
| 最後の10個のブロックヘッダーを取得します | なし |
|
| 大きなブロックのトランザクションIDのページを取得します |
、オプション:
|
|
統計データ
終点 | 説明 | 必須パラメータ | 回答例 |
| 特定の高さのブロック統計 |
|
|
| 一定期間のブロックマイニング統計 | オプション:
(デフォルトは7) |
|
| 鉱業統計の概要 | オプション:
(デフォルトは7) |
|
取引データ
終点 | 説明 | 必須パラメータ | 回答例 |
| 詳細な取引データ |
|
|
| 生のトランザクション16進データ |
|
|
| 取引領収書 |
|
|
| 1回のリクエストで複数のトランザクションを取得する |
(配列) |
|
住所データ
終点 | 説明 | 必須パラメータ | 回答例 |
| 住所の取引履歴 |
、オプション:
|
|
| アドレスの未使用出力 |
|
|
ネットワーク
終点 | 説明 | 必須パラメータ | 回答例 |
| APIヘルスチェック | なし |
|
使用例
bsv_exploreツールは、次のような自然言語プロンプトで使用できます。
内部的には、ツールは取得するデータを指定するためのパラメータを受け入れます。
endpoint: クエリする特定の WhatsOnChain エンドポイント (例:chain_info、tx_by_hash)network: 使用するBSVネットワーク(mainまたはtest)特定のエンドポイントに必要な追加パラメータ:
blockHash: block_by_hash および block_pages エンドポイント用blockHeight: block_by_height、tag_count_by_height、block_stats_by_heightエンドポイントの場合pageNumber: block_pagesエンドポイント(ページネーション)days: block_miner_stats および miner_summary_stats エンドポイントの場合 (デフォルトは 7)txHash: トランザクション関連のエンドポイント (tx_by_hash、tx_raw、tx_receipt)txids: bulk_tx_detailsエンドポイント用(トランザクションIDの配列)address: アドレス関連のエンドポイントの場合limit: address_history のページ区切り制限(オプション)
ネットワークオプション
このツールはメインネットとテストネットの両方をサポートしています。
main: Bitcoin SV メインネット(デフォルト)test:Bitcoin SV テストネット
発達
プロジェクトのセットアップ
プロジェクトに貢献したり、ローカルで実行したりしたい場合は、次の手順に従ってください。
リポジトリをクローンします。
git clone https://github.com/b-open-io/bsv-mcp.git cd bsv-mcp依存関係をインストールします:
bun install # or with npm npm install
サーバーの実行
テストの実行
ライセンス
このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。