bitcoin-utxo-mcp

用途

bitcoin-utxo-mcp 是一个基于 MCP（Model Context Protocol）的服务器，旨在追踪比特币的未花费交易输出（UTXO）和区块统计数据，为 AI 智能体提供直接访问关键链上数据的通道。通过该服务器，AI 客户端可以查询特定比特币地址的 UTXO 详情，以及特定区块的交易统计信息。

主要能力

该服务器提供以下工具和提示：

• get_utxo(address: str)：获取指定比特币地址的 UTXO 详情，包括 UTXO 数量、以 BTC 计的总价值以及交易详情。例如：
  • Address 1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa: 50 UTXOs, Total Value: 50.00000000 BTC, UTXO Details: ...
• get_block_stats(block_height: int)：获取指定比特币区块的交易统计信息，包括区块哈希、交易数量、总价值和区块时间。例如：
  • Block Height: 0, Block Hash: 000000000019d668..., Transactions: 1, Total Value: 50.00000000 BTC, Block Time: 1231006505
• analyze_bitcoin_flow()：一个可复用的提示模板，供 LLM 根据 UTXO 和区块数据分析比特币资金流向、网络健康状况以及潜在的市场影响。例如生成提示："Analyze the provided Bitcoin UTXO and block data: What do the UTXO distributions indicate about funds flow? ..."

使用方式

环境要求

• Python：3.10 或更高版本
• uv：一个快速现代的 Python 包管理器（安装说明见官方文档）

安装步骤

1. 克隆仓库：

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

2. 安装依赖：

   uv sync
   

3. 安装到 Claude Desktop：

   uv run mcp install main.py --name "Bitcoin UTXO"
   

   参考配置文件格式：

   {
     "mcpServers": {
       "Bitcoin UTXO": {
         "command": "uv",
         "args": [
           "--directory",
           "/path/to/bitcoin-utxo-mcp",
           "run",
           "main.py"
         ]
       }
     }
   }
   

   将 /path/to/bitcoin-utxo-mcp 替换为实际安装路径。

示例交互

在支持 MCP 的客户端（如 Claude Desktop）中，可以使用自然语言提示，例如：

• "Show me the UTXO details for the Bitcoin genesis address." 对应命令 get_utxo("1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa")，输出地址的 UTXO 数量、总价值及交易详情。
• "What's the transaction data for the Bitcoin genesis block?" 对应命令 get_block_stats(0)，输出创世区块的哈希、交易数量、总价值和区块时间。
• "Analyze Bitcoin funds flow and network health." 对应命令 analyze_bitcoin_flow()，生成供 LLM 分析的提示，LLM 可基于 UTXO 分布和区块统计给出关于资金流向、网络健康状况及市场影响的见解。

适用场景

• AI 智能体需要实时查询比特币链上数据以辅助决策。
• 研究人员或开发者通过 MCP 客户端分析比特币资金流动和网络状况。
• 结合 LLM 进行链上数据解读和市场趋势分析。

限制

• 依赖外部区块链 API（如 Blockchain.com）获取数据，示例中提及基于假设的 API 响应。
• 需要 Python 3.10+ 和 uv 包管理器环境。
• 当前提供的工具限于 UTXO 查询和区块统计，未涉及其他链上功能。
• 项目采用 MIT 许可证，详情参见 LICENSE 文件。