🚀 Mempool MCP Server

这是一个提供实时比特币区块链和内存池数据的模型上下文协议（MCP）服务器，由mempool.space的API驱动。您可以将此服务器作为工具提供商集成到兼容MCP的客户端（如Claude、Cursor等）中，以访问最新的比特币网络信息。这是一个非官方仓库。

---

🛠️ 可用的比特币工具

工具名称	描述
get-difficulty-adjustment	获取当前和下一个比特币难度调整信息。
get-price	获取当前BTC价格的各种法定货币。
get-historical-price	获取特定日期（YYYY-MM-DD）的BTC价格。
get-recommended-fees	获取推荐的比特币交易费用。
get-stats-info	获取比特币网络的一般统计数据。
get-mining-pools	获取挖矿池的信息。
get-mining-pool	获取特定挖矿池的信息。
get-mining-blocks-fees-224h	获取过去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的客户端。

---

⚡ 快速开始：在您的MCP客户端中使用

您可以在您的MCP客户端（如Claude、Cursor、VsCode等）中配置此服务器作为工具提供商：

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

[!TIP] 为了本地连接以保护隐私并实现无限调用，您可以从本地比特币节点（如Umbrel、MyNode等）传递基础mempool 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”文本工作。

<img src='https://github.com/alexandresanlim/mempool-mcp-server/blob/main/src/application/images/base_url_check.png?raw=true' width=600 />

享受！

或者

🛠️ 使用本地构建

1. 克隆此仓库：

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

2. 安装和构建：

npm install
npm run build
npm run server

3. 配置您的MCP客户端：

"mempool-mcp-server-debug": {
  "command": "node",
  "args": [
    "...replace_to_path_of_project/mempool-mcp-server/build/main.js"
  ]
},

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

---

📚 参考及故障排除

• 完整API参考：mempool.space API 文档
• 如果遇到问题，请确保您的构建是最新的，并且您的MCP客户端已配置为使用stdio。
• 对于问题或贡献，请随时打开一个issue或pull request！

---

由一位比特币爱好者制作。享受！