Bitcoin MCP Lsn

🚀 Bitcoin MCP サーバー

このサーバーは Go 言語で構築されたサービスで、様々な RPC コマンドを通じて、モデルコンテキストプロトコル（MCP）を使用してビットコインノードとの統一インターフェースを提供します。このサーバーは、ビットコインの RPC 機能を論理的なカテゴリに整理し、ブロックチェーンデータへのアクセスや操作を行うための、使いやすく文書化された API を提供します。

✨ 主な機能

• モデルコンテキストプロトコルを使用した包括的なビットコイン RPC インターフェース
• 機能別の分類:
  • ブロックチェーン操作
  • メモリプール操作
  • UTXO 操作
  • ブロックチェーン管理
• セキュリティ認証
• 包括的なエラー処理
• 使いやすく文書化された API

📦 インストール

前提条件

• Go 1.24 以上のバージョン
• RPC を有効にしたビットコインコアノード
• ビットコイン RPC コマンドの基本的な理解

インストール手順

1. リポジトリをクローンします：

git clone https://github.com/moncho/bitcoin-mcp.git
cd bitcoin-mcp

2. 依存関係をインストールします：

go mod download

3. サーバーをビルドします：

go build -o bitcoin-mcp

設定

構成ファイル（config.json）を作成し、以下の構造にします：

{
    "bitcoin": {
        "rpc_url": "http://localhost:8332",
        "username": "your_rpc_username",
        "password": "your_rpc_password"
    },
    "server": {
        "port": 8080,
        "host": "localhost"
    }
}

🚀 クイックスタート

サーバーの起動

1. ビットコインコアノードを起動し、RPC を有効にします：

bitcoind -server -rpcuser=your_rpc_username -rpcpassword=your_rpc_password

2. MCP サーバーを起動します：

./bitcoin-mcp -config config.json

または、環境変数を使用することもできます：

BITCOIN_RPC_URL=http://localhost:8332 \
BITCOIN_RPC_USER=your_rpc_username \
BITCOIN_RPC_PASS=your_rpc_password \
./bitcoin-mcp

💻 使用例

基本的な使用法

サーバーは、ビットコイン RPC コマンドにアクセスするための RESTful API を提供しています。以下はいくつかの例です：

ブロックチェーン情報の取得

curl -X POST http://localhost:8080/api/v1/blockchain/info

ブロックデータの取得

curl -X POST http://localhost:8080/api/v1/blockchain/block \
  -H "Content-Type: application/json" \
  -d '{"blockhash": "0000000000000000000123456789abcdef", "verbose": true}'

メモリプール情報の取得

curl -X POST http://localhost:8080/api/v1/mempool/info

高度な使用法

新しい RPC コマンドの追加

1. pkg/bitcoin/client.go でビットコイン RPC クライアントにメソッドを追加します。
2. pkg/tools/ ディレクトリで新しいコマンドの処理ロジックを実装します。
3. 新しいコマンドを処理するためにルートを更新します：
   • server/main.go に新しいルートを追加します。
   • 新しい処理関数を実装します。

ブロックブラウズコマンドの追加例

1. 新しいツールファイルを作成します：

package tools

import (
    "encoding/json"
    "log"
    "net/http"

    "github.com/moncho/bitcoin-mcp/pkg/api"
)

func BlockExplorer(w http.ResponseWriter, r *http.Request) {
    // ブロックハッシュを取得
    blockHash := getBlockHashFromRequest(r)
    
    // ブロックの詳細情報を取得
    blockData, err := api.GetBlockDetails(blockHash)
    if err != nil {
        log.Printf("ブロックの詳細情報を取得できません: %v", err)
        w.WriteHeader(http.StatusInternalServerError)
        return
    }

    // JSON レスポンスを返す
    w.Header().Set("Content-Type", "application/json")
    json.NewEncoder(w).Encode(blockData)
}

2. メインファイルを更新してルートを追加します：

package main

import (
    "log"
    
    "github.com/moncho/bitcoin-mcp/pkg/tools"
)

func main() {
    // サーバーを起動し、ルートを登録
    http.HandleFunc("/api/v1/block/explorer", tools.BlockExplorer)
    log.Fatal(http.ListenAndServe(":8080", nil))
}

🔧 技術詳細

プロジェクト構造

bitcoin-mcp/
├── cmd/
│   └── server/          # メインサーバーアプリケーション
├── pkg/
│   ├── bitcoin/         # ビットコイン RPC クライアント
│   └── tools/           # RPC コマンドの実装
├── config.json          # 設定ファイル
└── README.md           # このファイル

セキュリティに関する考慮事項

⚠️ 重要提示

• ログやエラーメッセージに API キーなどの機密情報を漏洩しないようにしてください。
• API 通信を保護するために HTTPS を使用し、デフォルトで TLS 暗号化を有効にしてください。
• API キーと証明書を定期的に更新し、不正アクセスのリスクを減らしてください。
• レート制限と認証メカニズムを設定し、乱用やサービス拒否攻撃を防止してください。

貢献ガイド

1. リポジトリをフォークします：Bitcoin-MCP
2. 機能ブランチを作成します：

git checkout -b feature/new-command

3. 変更をコミットし、プルリクエストを作成します。
4. 問題の議論やコミュニティへの貢献に参加します。

📄 ライセンス

このプロジェクトは MIT License の下でオープンソースとして公開されており、自由に使用および配布することができます。

連絡先

• メール: contact@bitcoin-mcp.com
• リポジトリ: Bitcoin-MCP
• フォーラム: Bitcoin-MCP 討論エリア