Mempool MCP

Mempool MCP服务器

一个MCP服务器，将Claude等AI助手连接到mempool.space或您自己的自托管实例。通过自然语言直接查询区块链数据、内存池统计、费用、矿池和闪电网络信息。

这是什么？

该服务器充当人工智能助手和比特币区块链数据之间的桥梁。配置后，您可以提出以下问题：

• “目前比特币区块的高度是多少？”
• “目前建议的交易费用是多少？”
• “显示此交易的详细信息：\[txid\]”
• “地址bc1q…的余额是多少？”
• “本周哪些矿池开采的区块最多？”
• “目前闪电网络的容量是多少？”

服务器支持连接到：

• 公共API：mempool.space（默认）
• 自托管：您自己的Mempool实例
• Tor：.onion隐私隐藏服务

特性

• 50+工具 覆盖所有Mempool API端点
• 灵活的连接：公共API、本地实例或Tor
• 自动Tor支持：连接到.onion地址时自动启动Tor
• 自定义SSL证书：支持本地实例上的自签名证书

______________________________________________________________________

公共API与自营

为什么选择自助主机？

公共mempool.space API具有可能中断大量使用的速率限制。 运行自己的Mempool实例没有速率限制--您可以根据需要快速、频繁地查询。

自助托管的好处

运行自己的内存池实例消除了这些限制：

运行一个完整的比特币节点来为你的Mempool实例供电也直接支持网络——每个节点都有助于验证和中继交易，提高比特币的去中心化和弹性。

自托管选项

• 孟普尔 -亲自运行整个堆栈
• 开始9 -在Start9 Embassy上一键安装
• 雨伞 -在Umbrel上一键安装
• 拉斯皮布利茨 -包含在RaspiBlitz中
• **** -包含在MyNode中

一旦你有了一个自托管的实例，只需指向 MEMPOOL_API_URL 并享受无限的查询。

______________________________________________________________________

需求

必需

• Python 3.11+
• 克劳德代码 或另一个MCP兼容客户端

可选（用于Tor连接）

• Tor -仅当连接到.onion地址时才需要

安装Tor

Linux（Debian/Ubuntu）：

sudo apt update && sudo apt install tor

Linux（Fedora）：

sudo dnf install tor

Linux（Arch）：

sudo pacman -S tor

macOS：

brew install tor

窗户：

Windows上的Tor有两种选择：

选项A:Tor专家包（建议用于MCP）

Expert Bundle在端口9050上作为后台守护进程运行Tor。默认情况下，这是MCP服务器所期望的。

1. 下载自
2. 提取到 C:\tor
3. 添加 C:\tor 到您的系统PATH
4. 重新启动终端

或者使用巧克力：

choco install tor

选项B:Tor浏览器

如果您已经安装了Tor浏览器，则可以使用它。Tor浏览器在端口上运行 9150 （不是9050），因此您需要相应地配置MCP服务器：

claude mcp add mempool-tor mempool-mcp --scope user --env MEMPOOL_API_URL=mempoolhqx4isw62xs7ldayuidyx2v2oethdhhj6mlo2r6ad.onion/api --env MEMPOOL_TOR_PROXY=socks5://127.0.0.1:9150 --env MEMPOOL_TOR_AUTO_START=false

重要提示： 使用此配置的MCP服务器时，必须运行Tor浏览器。

______________________________________________________________________

安装

Linux（Debian/Ubuntu）：

sudo apt install pipx
pipx install mempool-mcp

Linux（其他）/macOS：

pip install mempool-mcp
# Or use pipx if pip is blocked

窗户：

pip install mempool-mcp

______________________________________________________________________

配置

快速启动（公共API）

Linux/macOS：

claude mcp add mempool mempool-mcp --scope user --env MEMPOOL_API_URL=mempool.space/api

Windows（PowerShell）：

claude mcp add mempool mempool-mcp --scope user --env MEMPOOL_API_URL=mempool.space/api

注： 在Windows上，如果 mempool-mcp 未找到，请使用完整路径： ``powershell claude mcp add mempool "$env:APPDATA\Python\Python313\Scripts\mempool-mcp.exe" --scope user --env MEMPOOL_API_URL=mempool.space/api ``

重新启动Claude Code，然后问： *“目前比特币区块的高度是多少？”*

手动配置

添加到您的 ~/.claude.json （全球）或项目 .mcp.json:

______________________________________________________________________

选项1：公共API（mempool.space）

使用公共mempool.space API。无需额外设置。

{
  "mcpServers": {
    "mempool": {
      "type": "stdio",
      "command": "mempool-mcp",
      "env": {
        "MEMPOOL_API_URL": "mempool.space/api"
      }
    }
  }
}

______________________________________________________________________

选项2：自托管Mempool实例

连接到本地或网络上运行的Mempool实例。

{
  "mcpServers": {
    "mempool": {
      "type": "stdio",
      "command": "mempool-mcp",
      "env": {
        "MEMPOOL_API_URL": "http://localhost:8999/api"
      }
    }
  }
}

使用自定义SSL证书（例如Start9、Umbrel）：

{
  "env": {
    "MEMPOOL_API_URL": "https://your-node.local/api",
    "MEMPOOL_CA_CERT": "/path/to/your-ca-certificate.crt"
  }
}

禁用SSL验证（不建议用于生产）：

{
  "env": {
    "MEMPOOL_API_URL": "https://your-node.local/api",
    "MEMPOOL_SSL_VERIFY": "false"
  }
}

______________________________________________________________________

选项3:Tor隐藏服务（.onion）

通过Tor连接到Mempool，以获得最大的隐私。服务器将 自动启动Tor 如果它已安装但尚未运行。

{
  "mcpServers": {
    "mempool": {
      "type": "stdio",
      "command": "mempool-mcp",
      "env": {
        "MEMPOOL_API_URL": "mempoolhqx4isw62xs7ldayuidyx2v2oethdhhj6mlo2r6ad.onion/api"
      }
    }
  }
}

使用自定义Tor代理端口：

{
  "env": {
    "MEMPOOL_API_URL": "mempoolhqx4isw62xs7ldayuidyx2v2oethdhhj6mlo2r6ad.onion/api",
    "MEMPOOL_TOR_PROXY": "socks5://127.0.0.1:9150"
  }
}

禁用Tor自动启动（使用现有Tor实例）：

{
  "env": {
    "MEMPOOL_TOR_AUTO_START": "false"
  }
}

______________________________________________________________________

环境变量

______________________________________________________________________

可用工具

概述（6个工具）

Mempool（5个工具）

交易（8种工具）

积木（9个工具）

地址（7个工具）

采矿（11种工具）

闪电网络（6个工具）

______________________________________________________________________

使用示例

配置后，询问您的AI助手：

费用和Mempool：

• “目前建议的费用是多少？”
• “内存池现在有多拥挤？”
• “显示下一个投影块”

交易：

• “查找交易abc123…”
• “这笔交易确认了吗？”
• “此tx的哪些输出已被使用？”

地址：

• “bc1q的余额是多少？”
• “显示此地址的UTXO”
• “列出此地址的最近交易记录”

阻碍：

• “目前的街区高度是多少？”
• “显示区块800000的详细信息”
• “最新区块中有哪些交易？”

采矿：

• “本周哪个矿池开采的矿块最多？”
• “Foundry目前的哈希率是多少？”
• “显示过去一个月的网络哈希率”

闪电：

• “闪电网络的总容量是多少？”
• “查找名称中包含'ACINQ'的Lightning节点”
• “按容量显示前10个节点”

______________________________________________________________________

故障排除

MEMPOOL_API_URL 未设置

确保您的MCP配置包括 env 部分与 MEMPOOL_API_URL.

MCP服务器未连接/找不到命令（Windows）

之后 pip install mempool-mcp，可执行文件可能不在您的PATH中。解决：

选项1：使用MCP配置中的完整路径：

claude mcp add mempool "$env:APPDATA\Python\Python313\Scripts\mempool-mcp.exe" --scope user --env MEMPOOL_API_URL=mempool.space/api

选项2：将Python脚本添加到PATH：

[Environment]::SetEnvironmentVariable("Path", $env:Path + ";$env:APPDATA\Python\Python313\Scripts", "User")

然后重新启动终端。

Tor连接问题

“未安装Tor”错误：

• Linux/macOS： 使用您的包管理器（apt、dnf、pacman、brew）进行安装
• 窗户： 安装 Tor专家包 并添加到PATH

Tor代理连接失败：

1. 验证是否安装了Tor： which tor （Linux/macOS）或 where tor （Windows）
2. 检查端口：

- Tor守护进程/Expert Bundle使用端口 9050 （默认） - Tor浏览器使用端口 9150

1. 测试连接性：

   # Linux/macOS
   curl --socks5-hostname 127.0.0.1:9050 check.torproject.org

   # Windows PowerShell
   Test-NetConnection -ComputerName 127.0.0.1 -Port 9050

使用Tor浏览器而不是Tor守护进程：

在MCP配置中设置这些环境变量：

{
  "env": {
    "MEMPOOL_TOR_PROXY": "socks5://127.0.0.1:9150",
    "MEMPOOL_TOR_AUTO_START": "false"
  }
}

SSL证书错误

对于具有自签名证书的自托管实例：

• 集 MEMPOOL_CA_CERT 到您的CA证书路径，或
• 集 MEMPOOL_SSL_VERIFY=false （不建议用于生产）

服务器未在Claude中显示

1. 修改后重新启动Claude Code ~/.claude.json
2. 确保 mempool-mcp 在您的PATH中（尝试运行 mempool-mcp --help)
3. 跑 /mcp 在Claude中查看服务器状态

______________________________________________________________________

许可证

麻省理工学院

______________________________________________________________________

链接

• PyPI包
• Mempool.空间
• Mempool API文档
• MCP协议
• 克劳德代码