JinDaGe - mempool-mcp-server MCP Details

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” 文本检查是否正常工作。

🛠️ 使用本地构建

克隆此仓库：

git clone https://github.com/alexandresanlim/mempool-mcp-server.git

安装并构建：

npm install
npm run build
npm run server

配置你的 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 或提交拉取请求！

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

mempool-mcp-server