Bitcoin MCP Lsn

一個基於Go語言的比特幣節點交互服務，通過Model Context Protocol (MCP)提供統一的RPC命令接口，支持區塊鏈、內存池、UTXO等操作，具有安全認證和錯誤處理功能。

金融開發者工具 #比特幣服務 #RPC接口 #區塊鏈工具 #Go開發 .Go

rating : 2 points

downloads : 10

update time : 2025-04-23

功能概述

MCP服務器為開發者提供了訪問比特幣網絡的安全且易於使用的接口。它抽象了複雜的低級別RPC交互，允許構建更高層次的應用程序。

核心組件

該系統由三個主要部分組成：API網關負責接收和路由請求，MCP協議處理器處理比特幣節點的通信，以及事務管理器確保操作的原子性和一致性。

使用場景

適用於需要與比特幣網絡交互的應用程序開發，如錢包服務、交易驗證工具和區塊鏈分析平臺。它特別適合希望避免直接處理底層RPC細節的開發者。

協議轉換將高級別請求轉換為適合比特幣節點的低級別RPC命令。

事務管理確保所有操作要麼全部完成，要麼全部不完成，從而維護數據一致性。

訪問控制支持基於API密鑰和IP白名單的多級權限管理。

安裝依賴項

配置服務器

啟動服務

是否需要運行比特幣節點才能使用此服務？

在生產環境中使用安全嗎？

比特幣核心文檔

比特幣核心節點的官方文檔。

MCP協議規範

詳細描述了MCP協議的工作原理和接口定義。作為開放標準，歡迎社區貢獻與反饋。

🚀 Bitcoin MCP 服務器

Bitcoin MCP 服務器是一個基於 Go 語言開發的服務，藉助模型上下文協議（MCP），通過各類 RPC 命令提供統一接口，實現與比特幣節點的交互。它將比特幣 RPC 功能進行邏輯分類，為訪問區塊鏈數據和操作提供簡潔且文檔完備的 API。

🚀 快速開始

在使用 Bitcoin MCP 服務器之前，需要確保滿足以下先決條件：

Go 1.24 或更高版本
啟用 RPC 的比特幣核心節點
對比特幣 RPC 命令的基本理解

✨ 主要特性

全面的比特幣 RPC 接口：採用模型上下文協議，提供全面的比特幣 RPC 接口。
功能分類清晰：
- 區塊鏈操作
- 內存池操作
- UTXO 操作
- 區塊鏈管理
安全認證：具備安全認證機制，保障系統安全。
全面錯誤處理：對各種錯誤情況進行全面處理，增強系統穩定性。
簡潔且有文檔記錄的 API：API 設計簡潔，同時附帶詳細文檔說明。

📦 安裝指南

克隆倉庫

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

安裝依賴項

go mod download

構建服務器

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

運行服務器

啟動比特幣核心節點並啟用 RPC

bitcoind -server -rpcuser=your_rpc_username -rpcpassword=your_rpc_password

啟動 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

API 使用

服務器提供了用於訪問比特幣 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

開發

項目結構

bitcoin-mcp/
├── cmd/
│   └── server/          # 主服務器應用程序
├── pkg/
│   ├── bitcoin/         # 比特幣 RPC 客戶端
│   └── tools/           # RPC 命令實現
├── config.json          # 配置文件
└── README.md           # 本文件

添加新的 RPC 命令

在 pkg/bitcoin/client.go 中添加方法到比特幣 RPC 客戶端。
在 pkg/tools/ 目錄下實現新的命令處理邏輯。
更新路由以處理新命令：
- 添加新的路由到 server/main.go。
- 實現新的處理函數。

示例：添加區塊瀏覽命令

創建新的工具文件

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

更新主文件以添加路由

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