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 も動作しますが、同じパフォーマンス上の利点が得られない可能性があります。

Related MCP server: MCP Blockchain Query Server

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>"
      }
    }
  }
}

5. <your_private_key_wif>を実際の秘密鍵 WIF に置き換えてください（安全な場所に保管してください！）。WIF をお持ちでない場合は、今のところ省略できますが、ウォレットを必要とするツールは使用できなくなります。 <your_identity_key_wif>もオプションです。これは、提供された ID キーを使用して、Sigma プロトコルで 1Sat Ordinals に署名します。

6. 「保存」をクリック

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

3. 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>"
         }
       }
     }
   }

4. <your_private_key_wif>を実際の秘密鍵 WIF に置き換えます。

5. ファイルを保存し、Claude for Desktopを再起動します。

6. Claude for Desktopのツールアイコン（ハンマー）をクリックするとBSVツールが表示されます。

npm ユーザー向けの代替手段 (Claude)

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

利用可能なツール

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

ウォレットツール

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

BSVツール

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

序数ツール

BSVで序数（NFT）を操作するためのツール：

ユーティリティツール

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

MNEEツール

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

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_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ブロックチェーンへの包括的なアクセスを提供します。この強力なエクスプローラーツールを使用すると、チェーンデータ、ブロック、トランザクション、アドレス情報など、ブロックチェーンのさまざまな側面を照会できます。

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

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

チェーンデータ

ブロックデータ

統計データ

取引データ

住所データ

ネットワーク

使用例

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_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 テストネット

発達

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

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

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ファイルを参照してください。