Bitcoin SV MCP Server

MIT License
996
10
  • Apple
  • Linux

Integrations

  • Provides wallet functionality, BSV blockchain interaction, ordinals/NFT management, and utility tools for Bitcoin SV. Capabilities include retrieving addresses, sending transactions, purchasing NFTs, getting price information, working with ordinals, and managing BSV20 tokens.

  • Uses Bun as the JavaScript runtime for the MCP server, enabling fast execution of the Bitcoin SV tools and capabilities.

Bitcoin SV MCP サーバー

⚠️ 注意: 実験作業進行中
このプロジェクトはまだ初期段階の実験段階です。機能は変更される可能性があり、APIはまだ安定していません。貢献、フィードバック、バグ報告を歓迎します!お気軽に問題を報告したり、プルリクエストを送信してください。

モデルコンテキストプロトコル(MCP)フレームワーク用のBitcoin SV(BSV)ツールのコレクション。このライブラリは、BSVブロックチェーンとの連携に必要なウォレット、序数、ユーティリティ関数を提供します。

インストールとセットアップ

パンを使用する(オプションですが推奨)

このプロジェクトは、高速なJavaScriptランタイム兼パッケージマネージャーであるBunを使用して構築されています。最高のパフォーマンスを得るにはBunの使用が推奨されますが、BunはNode.jsとの下位互換性を持つように設計されているため、サーバーはNode.jsとnpmでも実行できます。

Bunのインストール

macOS (Homebrew を使用):

brew install oven-sh/bun/bun

macOS/Linux/WSL (インストーラー スクリプトを使用):

curl -fsSL https://bun.sh/install | bash

Windows: Windows ユーザーは、Bun を実行するために WSL (Windows Subsystem for Linux) または Docker を使用する必要があります。

Node.js と npm も動作しますが、同じパフォーマンス上の利点が得られない可能性があります。

MCPクライアントへの接続

このサーバーはモデルコンテキストプロトコル(MCP)を実装しており、AIアシスタントがBitcoin SVの機能を利用できるようにします。このサーバーは、MCP対応の様々なクライアントに接続できます。

注: PRIVATE_KEY_WIF環境変数はオプションになりました。この環境変数を指定しないと、サーバーは教育リソースとウォレット以外のツールが利用可能な制限モードで動作します。ウォレットとMNEEトークンの操作には有効な秘密鍵が必要です。また、 IDENTITY_KEY_WIF環境変数を設定することで、認証、キュレーション、信頼の輪のための序数表記のシグマプロトコル署名を有効にすることもできます。

カーソル

Cursorで BSV MCP サーバーを使用するには:

  1. まだインストールしていない場合は、Cursorをインストールしてください。
  2. カーソルを開き、設定→拡張機能→モデルコンテキストプロトコルに移動します。
  3. 「新しいグローバルMCPサーバーを追加」をクリックします
  4. 次の構成を JSON 形式で入力します。
{ "mcpServers": { "Bitcoin SV": { "command": "bunx", "args": [ "bsv-mcp@latest" ], "env": { "PRIVATE_KEY_WIF": "<your_private_key_wif>", "IDENTITY_KEY_WIF": "<your_identity_key_wif>" } } } }
  1. <your_private_key_wif>を実際の秘密鍵 WIF に置き換えてください(安全な場所に保管してください!)。WIF をお持ちでない場合は、今のところ省略できますが、ウォレットを必要とするツールは使用できなくなります。 <your_identity_key_wif>もオプションです。これは、提供された ID キーを使用して、Sigma プロトコルで 1Sat Ordinals に署名します。
  2. 「保存」をクリック

BSV ツールは、「Bitcoin SV」名前空間の Cursor の AI アシスタントで利用できるようになります。

npmユーザー向けの代替手段

Bun の代わりに npm を使用する場合:

{ "mcpServers": { "Bitcoin SV": { "command": "npx", "args": [ "bsv-mcp@latest" ], "env": { "PRIVATE_KEY_WIF": "<your_private_key_wif>", "IDENTITY_KEY_WIF": "<your_identity_key_wif>" } } } }

デスクトップ版クロード

このサーバーをClaude for Desktopに接続するには:

  1. Claude for Desktopを開き、Claude > 設定 > 開発者に移動します。
  2. 「設定の編集」をクリックします。

Claude の設定 JSON ファイルを、お好きなテキストエディタで開きます。CLI から実行する場合は、以下の手順を実行してください。

# macOS/Linux code ~/Library/Application\ Support/Claude/claude_desktop_config.json # Windows code %APPDATA%\Claude\claude_desktop_config.json
  1. 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>" } } } }
  2. <your_private_key_wif>を実際の秘密鍵 WIF に置き換えます。
  3. ファイルを保存し、Claude for Desktopを再起動します。
  4. Claude for Desktopのツールアイコン(ハンマー)をクリックするとBSVツールが表示されます。
npm ユーザー向けの代替手段 (Claude)

Bun の代わりに npm を使用する場合は、「command」フィールドを「npx」に置き換えます。

利用可能なツール

ツールキットはいくつかのカテゴリに分類されています。

ウォレットツール

ウォレットツールはBSVウォレットのコア機能を提供します。

ツール名説明出力例
wallet_getPublicKey指定されたプロトコルとキーIDの公開キーを取得します{"publicKey":"032d0c73eb9270e9e009fd1f9dd77e19cf764fbad5f799560c4e8fd414e40d6fc2"}
wallet_createSignature提供されたデータの暗号署名を作成する{"signature":[144,124,85,193,226,45,140,249,9,177,11,167,33,215,209,38,...]}
wallet_verifySignature提供されたデータに対して暗号署名を検証する{"isValid":true}
wallet_encryptionウォレットの暗号鍵を使用してデータを暗号化および復号化するための複合ツール。例: 1. テキストを暗号化: "Encrypt this message: Hello World" 2. データを復号化: "Decrypt this data that was previously encrypted for me"暗号化: {"ciphertext":[89,32,155,38,125,22,49,226,26,...]}復号化: {"plaintext":"hello world"}
wallet_getAddress現在のウォレットのBSVアドレスまたは派生パスを返します{"address":"1ExampleBsvAddressXXXXXXXXXXXXXXXXX","status":"ok"}
wallet_sendToAddress指定されたアドレスにBSVを送信します(BSVまたはUSDの金額をサポート){"status":"success","txid":"a1b2c3d4e5f6...","satoshis":1000000}
wallet_purchaseListingマーケットプレイスのリストからNFTまたはBSV-20/BSV-21トークンを購入する{"status":"success","txid":"a1b2c3d4e5f6...","type":"nft","origin":"abcdef123456..."}
wallet_createOrdinalsBSVブロックチェーン上に序数を作成して刻み込む{"txid":"a1b2c3d4e5f6...","inscriptionAddress":"1ExampleAddress...","contentType":"image/png"}

BSVツール

BSVブロックチェーンおよびネットワークとやり取りするためのツール:

ツール名説明出力例
bsv_getPrice取引所APIから現在のBSV価格を取得しますCurrent BSV price: $38.75 USD
bsv_decodeTransactionBSVトランザクションをデコードし、詳細情報を返します{"txid":"a1b2c3d4e5f6...","version":1,"locktime":0,"size":225,"inputs":[...],"outputs":[...]}
bsv_exploreWhatsOnChain APIエンドポイントにアクセスできる包括的なブロックチェーンエクスプローラーツール{"chain_info":{"chain":"main","blocks":826458,"headers":826458,"bestblockhash":"0000000000..."}}

序数ツール

BSVで序数(NFT)を操作するためのツール:

ツール名説明出力例
ordinals_getInscription特定の碑文に関する詳細情報を取得します{"id":"a1b2c3d4e5f6...","origin":"a1b2c3d4e5f6...","contentType":"image/png","content":"iVBORw0KGgoAAA..."}
ordinals_searchInscriptionsさまざまな基準に基づいて碑文を検索する{"results":[{"id":"a1b2c3...","contentType":"image/png","owner":"1Example..."},...]}
ordinals_marketListings統一されたインターフェースでNFT、BSV-20、BSV-21トークンの市場リストを取得します{"results":[{"txid":"a1b2c3...","price":9990000,"tick":"PEPE","listing":true},...]}
ordinals_marketSalesBSV-20およびBSV-21トークンの市場販売に関する情報を取得します{"results":[{"txid":"a1b2c3...","price":34710050,"tick":"$BTC","sale":true},...]}
ordinals_getTokenByIdOrTickerIDで特定のBSV20トークンの詳細を取得します{"tick":"PEPE","max":"21000000","lim":"1000","dec":"2"}

ユーティリティツール

汎用ユーティリティ関数:

ツール名説明出力例
utils_convertData異なるエンコード形式 (utf8、16 進数、base64、バイナリ) 間でデータを変換します。パラメータ: - data (必須): 変換する文字列from (必須): ソースエンコード形式 (utf8、16 進数、base64、またはバイナリ) - to (必須): ターゲットエンコード形式 (utf8、16 進数、base64、またはバイナリ)例: - UTF-8 から 16 進数: {"data": "hello world", "from": "utf8", "to": "hex"}68656c6c6f20776f726c64 - UTF-8 から base64: {"data": "Hello World", "from": "utf8", "to": "base64"}SGVsbG8gV29ybGQ= - base64 から UTF-8: {"data": "SGVsbG8gV29ybGQ=", "from": "base64", "to": "utf8"}Hello World - 16 進数から base64: {"data": "68656c6c6f20776f726c64", "from": "hex", "to": "base64"}aGVsbG8gd29ybGQ=注: - すべてのパラメータは必須です - ツールは変換されたデータを文字列として返します - バイナリ変換の場合、データはバイト値の配列として表されます"SGVsbG8gV29ybGQ=" (UTF-8の「Hello World」をbase64に変換)

MNEEツール

MNEE トークンを操作するためのツール:

ツール名説明出力例
mnee_getBalanceウォレットの現在のMNEEトークン残高を取得します{"balance": {"amount": 2900, "decimalAmount": 0.029}}
mnee_sendMneeMNEEトークンを指定のアドレスに送信します。MNEEとUSDの両方の金額をサポートします。{"success": true, "txid": "d1ce853934964e6c1fe9f44c918a824f175c6ab466b966f49ebc0682a8318895", "rawtx": "0100000002a0be40d8942015f1...", "mneeAmount": 0.01, "usdAmount": "$0.01", "recipient": "15mNxEkyKJXPD8amic6oLUjS45zBKQQoLu"}
mnee_parseTxMNEE取引を解析して、その操作と金額に関する詳細情報を取得します。金額はすべて小数点以下5桁の原子単位で表されます(例:1000原子単位 = 0.01 MNEE)。{"txid": "d1ce853934964e6c1fe9f44c918a824f175c6ab466b966f49ebc0682a8318895", "environment": "production", "type": "transfer", "inputs": [{"address": "18izL7Wtm2fx3ALoRY3MkY2VFSMjArP62D", "amount": 2900}], "outputs": [{"address": "15mNxEkyKJXPD8amic6oLUjS45zBKQQoLu", "amount": 1000}, {"address": "19Vq2TV8aVhFNLQkhDMdnEQ7zT96x6F3PK", "amount": 100}, {"address": "18izL7Wtm2fx3ALoRY3MkY2VFSMjArP62D", "amount": 1800}]}

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テクノロジーに関するより正確で詳細な回答を提供できます。ユーザーは以下のことができます。

  1. 特定のトピックについて質問する:「Bitcoin SV のオーディナルについて教えてください」または「BSV SDK のトランザクション構築について説明してください」
  2. 具体的な BRC の詳細をリクエストします。「BRC 8 では何が規定されていますか?」または「トランザクション作成時の BRC を表示してください」
  3. 一般的な概要を確認する:「BSV SDK とは何ですか?」または「すべての BRC の概要を表示してください」

これらのプロンプトとリソースにより、AI の知識ベースが強化され、複雑な Bitcoin SV トピックに対しても、より技術的で正確な応答が可能になります。

MCPの仕組み

MCP 対応の AI アシスタントと対話する場合:

  1. AIがあなたのリクエストを分析し、どのツールを使用するかを決定します
  2. 承認されると、適切なBSV MCPツールが呼び出されます。
  3. サーバーはビットコインSVブロックチェーン上で要求された操作を実行する
  4. 結果はAIアシスタントに返されます
  5. アシスタントは自然な会話形式で情報を提示します

カスタマイズオプション

BSV MCP サーバーは、環境変数を使用して特定のコンポーネントを有効または無効にすることでカスタマイズできます。

コンポーネント構成

環境変数デフォルト説明
DISABLE_PROMPTSfalseすべての教育プロンプトを無効にするには、 trueに設定します
DISABLE_RESOURCESfalseすべてのリソース(BRC、変更ログ)を無効にするには、 trueに設定します。
DISABLE_TOOLSfalseすべてのツールを無効にするにはtrueに設定します

ツール固有の構成

環境変数デフォルト説明
DISABLE_WALLET_TOOLSfalseBitcoinウォレットツールを無効にするにはtrueに設定します
DISABLE_MNEE_TOOLSfalseMNEEトークンツールを無効にするにはtrueに設定します
DISABLE_BSV_TOOLSfalseBSVブロックチェーンツールを無効にするにはtrueに設定してください
DISABLE_ORDINALS_TOOLSfalse序数/NFTツールを無効にするにはtrueに設定してください
DISABLE_UTILS_TOOLSfalseユーティリティツールを無効にするにはtrueに設定します
IDENTITY_KEY_WIFnot set識別キー用のオプションの WIF。設定されている場合、序数の刻印は認証、キュレーション、および信頼の Web のためにシグマ プロトコルで署名されます。
DISABLE_BROADCASTINGfalsetrueに設定すると、トランザクションのブロードキャストが無効になります。代わりに、生のトランザクションの16進数を返します。ブロードキャスト前のテストやトランザクションの確認に役立ちます。

ツールを使わず、教育リソースとプロンプトのみで実行します。

DISABLE_TOOLS=true bunx bsv-mcp@latest

ウォレットやその他の機能なしで、BSV ツールのみで実行します。

DISABLE_PROMPTS=true DISABLE_RESOURCES=true DISABLE_WALLET_TOOLS=true DISABLE_MNEE_TOOLS=true DISABLE_ORDINALS_TOOLS=true DISABLE_UTILS_TOOLS=true bunx bsv-mcp@latest

ウォレット操作以外のすべてのツールを使用します。

DISABLE_WALLET_TOOLS=true bunx bsv-mcp@latest

ブロードキャストせずにトランザクションを作成する (ドライラン モード):

DISABLE_BROADCASTING=true bunx bsv-mcp@latest

トラブルシューティング

BSV MCP サーバーに問題がある場合:

接続の問題

  1. システムにBunまたはNode.jsがインストールされていることを確認してください
  2. WIF秘密鍵が環境に正しく設定されていることを確認します
  3. クライアントがMCPをサポートし、適切に構成されていることを確認してください。
  4. クライアントのコンソール出力でエラーメッセージを探します

Bunを最新の状態に保つ

互換性を確保するために、Bun を最新バージョンに更新しておくことが重要です。

# Update Bun to the latest version bun upgrade

現在の Bun バージョンを確認するには:

bun --version

ログ記録とデバッグ

Claude for Desktop の場合は、次のログを確認してください。

# macOS/Linux tail -n 20 -f ~/Library/Logs/Claude/mcp*.log # Windows type %APPDATA%\Claude\Logs\mcp*.log

カーソルの場合は、[設定] → [拡張機能] → [モデル コンテキスト プロトコル] でカーソル 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ブロックチェーンへの包括的なアクセスを提供します。この強力なエクスプローラーツールを使用すると、チェーンデータ、ブロック、トランザクション、アドレス情報など、ブロックチェーンのさまざまな側面を照会できます。

利用可能なエンドポイント

このツールは、次のエンドポイント カテゴリと特定のエンドポイントをサポートしています。

チェーンデータ
終点説明必須パラメータ回答例
chain_infoネットワーク統計、難易度、チェーンワークなし{"chain":"main","blocks":826458,"headers":826458,"bestblockhash":"0000000000..."}
chain_tips高さや状態を含む現在のチェーンのヒントなし[{"height":826458,"hash":"000000000000...","branchlen":0,"status":"active"}]
circulating_supply現在のBSV流通供給量なし{"bsv":21000000}
peer_info接続されたピアの統計なし[{"addr":"1.2.3.4:8333","services":"000000000000...","lastsend":1621234567}]
ブロックデータ
終点説明必須パラメータ回答例
block_by_hashハッシュによるブロックデータの完全化blockHash{"hash":"000000000000...","confirmations":1000,"size":1000000,...}
block_by_height高さでブロックデータを完了するblockHeight{"hash":"000000000000...","confirmations":1000,"size":1000000,...}
tag_count_by_height特定のブロックのタグ数の統計blockHeight{"tags":{"amp":3,"bitkey":5,"metanet":12,"planaria":7,"b":120}}
block_headers最後の10個のブロックヘッダーを取得しますなし[{"hash":"000000000000...","height":826458,"version":536870912,...},...]
block_pages大きなブロックのトランザクションIDのページを取得しますblockHash 、オプション: pageNumber["tx1hash","tx2hash","tx3hash",...]
統計データ
終点説明必須パラメータ回答例
block_stats_by_height特定の高さのブロック統計blockHeight{"size":123456,"txCount":512,"outputTotal":54.12345678,"outputTotalUsd":2345.67,...}
block_miner_stats一定期間のブロックマイニング統計オプション: days (デフォルトは7){"blocks":{"miner1":412,"miner2":208,...},"total":1008}
miner_summary_stats鉱業統計の概要オプション: days (デフォルトは7){"totalBlocks":1008,"totalFees":1.23456789,"totalFeesUsd":53.67,...}
取引データ
終点説明必須パラメータ回答例
tx_by_hash詳細な取引データtxHash{"txid":"a1b2c3d4e5f6...","version":1,"locktime":0,"size":225,...}
tx_raw生のトランザクション16進データtxHash"01000000012345abcdef..."
tx_receipt取引領収書txHash{"blockHash":"000000000000...","blockHeight":800000,"confirmations":26458}
bulk_tx_details1回のリクエストで複数のトランザクションを取得するtxids (配列)[{"txid":"a1b2c3d4e5f6...","version":1,...}, {"txid":"b2c3d4e5f6a7...","version":1,...}]
住所データ
終点説明必須パラメータ回答例
address_history住所の取引履歴address 、オプション: limit[{"tx_hash":"a1b2c3d4e5f6...","height":800000},...]
address_utxosアドレスの未使用出力address[{"tx_hash":"a1b2c3d4e5f6...","tx_pos":0,"value":100000},...]
ネットワーク
終点説明必須パラメータ回答例
healthAPIヘルスチェックなし{"status":"synced"}

使用例

bsv_exploreツールは、次のような自然言語プロンプトで使用できます。

"Get the current Bitcoin SV blockchain information" "Show me block #800000 details" "Get tag count statistics for block #800000" "Fetch transaction history for address 1ExampleBsvAddressXXXXXXXX" "Get unspent outputs for my wallet address" "Check transaction details for txid a1b2c3d4e5f6..." "What is the current BSV circulating supply?" "Show me the latest block headers" "Get transaction IDs for page 2 of a large block" "Show me block statistics for height 800000" "What are the mining statistics for the last 14 days?" "Get a summary of mining activity over the past 30 days" "Retrieve details for multiple transactions in a single query"

内部的には、ツールは取得するデータを指定するためのパラメータを受け入れます。

  • endpoint : クエリする特定の WhatsOnChain エンドポイント (例: chain_infotx_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 テストネット

発達

プロジェクトのセットアップ

プロジェクトに貢献したり、ローカルで実行したりしたい場合は、次の手順に従ってください。

  1. リポジトリをクローンします。
    git clone https://github.com/b-open-io/bsv-mcp.git cd bsv-mcp
  2. 依存関係をインストールします:
    bun install # or with npm npm install

サーバーの実行

bun run index.ts # or with npm npm run start

テストの実行

bun test # or with npm npm test

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

AI アシスタントがウォレット操作、序数 (NFT)、およびさまざまなブロックチェーン ユーティリティを通じて BSV ブロックチェーンと対話できるようにする、モデル コンテキスト プロトコル用の Bitcoin SV ツールのコレクション。

  1. Installation and Setup
    1. Use Bun (Optional but recommended)
  2. Connecting to MCP Clients
    1. Cursor
    2. Claude for Desktop
  3. Available Tools
    1. Wallet Tools
    2. BSV Tools
    3. Ordinals Tools
    4. Utility Tools
    5. MNEE Tools
  4. Using the Tools with MCP
    1. Wallet Operations
    2. Ordinals (NFTs)
    3. Blockchain Operations
    4. Data Conversion
  5. MCP Prompts and Resources
    1. Available Prompts
    2. Available Resources
    3. Using Prompts and Resources
  6. How MCP Works
    1. Customization Options
      1. Component Configuration
      2. Tool-Specific Configuration
      3. Examples
    2. Troubleshooting
      1. Connection Issues
      2. Keeping Bun Up to Date
      3. Logging and Debugging
    3. Recent Updates
      1. Bitcoin SV Blockchain Explorer
        1. Available Endpoints
        2. Usage Examples
        3. Network Options
      2. Development
        1. Project Setup
        2. Running the Server
        3. License

      Related MCP Servers

      • -
        security
        F
        license
        -
        quality
        A Model Context Protocol server that enables AI assistants to access Flow blockchain data and perform operations such as checking balances, resolving domains, executing scripts, and submitting transactions.
        Last updated -
        JavaScript
        • Linux
        • Apple
      • A
        security
        F
        license
        A
        quality
        Implements the Model Context Protocol to allow AI models to access and interact with blockchain data, including reading contract states, retrieving events, and accessing transaction information across various networks.
        Last updated -
        10
        45
        30
        TypeScript
      • -
        security
        A
        license
        -
        quality
        A Model Context Protocol server for integrating AI assistants like Claude Desktop with the Stellar blockchain, enabling wallet connections, token listings, balance queries, and fund transfers.
        Last updated -
        JavaScript
        MIT License
        • Apple
        • Linux
      • -
        security
        F
        license
        -
        quality
        A Model Context Protocol server that connects Claude AI with SOON and other SVM-based blockchains, allowing users to check account balances, fetch recent transactions, and view token holdings on SOON's testnet and mainnet.
        Last updated -
        1
        JavaScript

      View all related MCP servers

      ID: 2tjvjasfmo