返回 MCP 目录
public公开dns本地运行

mempool-mcp-server

一个基于MCP协议的比特币区块链和内存池数据实时查询服务,通过mempool.space API提供多种比特币网络信息查询工具,支持MCP兼容客户端集成。

article

README

🚀 Mempool MCP 服务器

这是一个模型上下文协议(MCP)服务器,它借助 mempool.space 的 API,提供实时的比特币区块链和内存池数据。你可以在兼容 MCP 的客户端(如 Claude、Cursor 等)中,将此服务器作为工具提供者,来获取最新的比特币网络信息。这是一个非官方的仓库。

🚀 快速开始

你可以在像 Claude、Cursor、VsCode 等 MCP 客户端中,将此服务器配置为工具提供者:

"mempool-mcp-server": {
  "command": "npx",
  "args": [
    "@sanlim/mempool-mcp-server"
  ]
},

⚠️ 重要提示

若想出于隐私考虑并进行无限制调用而进行本地连接,你可以从本地比特币节点(如 Umbrel、MyNode 等)将基础内存池 API URL 作为环境配置传入。如下所示:

"mempool-mcp-server-local": {
 "command": "npx",
 "args": [
   "@sanlim/mempool-mcp-server"
 ],
 "env": {
   "MEMPOOL_BASE_URL": "http://umbrel.local:3006/api"
 }
},

在你的 MCP 客户端中使用 “mempool url” 文本检查是否正常工作。

🛠️ 使用本地构建

  1. 克隆此仓库:
git clone https://github.com/alexandresanlim/mempool-mcp-server.git
  1. 安装并构建:
npm install
npm run build
npm run server
  1. 配置你的 MCP 客户端:
"mempool-mcp-server-debug": {
  "command": "node",
  "args": [
    "...replace_to_path_of_project/mempool-mcp-server/build/main.js"
  ]
},

服务器将启动并通过标准输入/输出监听 MCP 请求。🎉

✨ 主要特性

🛠️ 可用的比特币工具

| 工具名称 | 描述 | |-----------|-------------| | get-difficulty-adjustment | 获取当前和下一次比特币难度调整信息。 | | get-price | 获取比特币当前以各种法定货币计价的价格。 | | get-historical-price | 获取特定日期(YYYY - MM - DD)的比特币价格。 | | get-recommended-fees | 获取推荐的比特币交易费用。 | | get-stats-info | 获取比特币网络的一般统计信息。 | | get-mining-pools | 获取矿池信息。 | | get-mining-pool | 获取特定矿池的信息。 | | get-mining-blocks-fees-24h | 获取过去 24 小时内挖矿区块的费用。 | | get-mempool-info | 获取内存池信息。 | | get-mempool-txids | 获取内存池中的交易 ID。 | | get-mempool-recent | 获取内存池中的近期交易。 | | get-blocks | 获取最新的区块。 | | get-block | 根据区块哈希获取区块的详细信息。 | | get-block-txids | 获取区块中的交易 ID。 | | get-block-txs | 获取区块中的交易。 | | get-block-status | 获取区块状态。 | | get-block-raw | 获取原始的区块十六进制数据。 | | get-block-txid-by-index | 通过索引获取区块中的交易 ID。 | | get-block-header | 获取十六进制格式的区块头。 | | get-address-info | 获取地址的详细信息。 | | get-address-txs | 获取地址的交易信息。 | | get-address-txs-chain | 获取地址在链上的交易信息。 | | get-address-txs-mempool | 获取地址在内存池中的交易信息。 | | get-address-utxo | 获取地址的未花费交易输出(UTXO)。 | | get-tx-info | 获取交易的详细信息。 | | get-tx-status | 获取交易状态。 | | get-tx-raw | 获取原始的交易十六进制数据。 | | get-tx-merkleblock-proof | 获取交易的默克尔块证明。 | | get-tx-outspend | 获取交易输出的支出信息。 | | get-tx-outspends | 获取交易所有输出的支出信息。 |

📚 详细文档

🤖 什么是 MCP?

模型上下文协议(MCP) 是一种标准,用于工具提供者通过标准输入/输出与 AI 客户端进行通信。此服务器允许你将比特币数据工具集成到任何兼容 MCP 的客户端中。

📚 参考与故障排除

  • 完整的 API 参考:mempool.space API 文档
  • 若遇到问题,请确保你的构建是最新的,并且你的 MCP 客户端配置为使用标准输入/输出。
  • 如有疑问或想贡献代码,请随时创建 issue 或提交拉取请求!

由一位比特币爱好者用心打造。祝你使用愉快!

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端