Bitcoin MCP Lsn

一个基于Go语言的比特币节点交互服务，通过Model Context Protocol (MCP)提供统一的RPC命令接口，支持区块链、内存池、UTXO等操作，具有安全认证和错误处理功能。

金融开发者工具 #比特币服务 #RPC接口 #区块链工具 #Go开发 .Go

评分 : 2分

下载量 : 8.7K

更新时间 : 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))
}