← 返回目录

Hummingbot MCP Server

官方

已归档

通过 MCP 连接 Hummingbot，实现多交易所自动化加密货币交易

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 开发工具第 243 / 438
Stars: ★ 59 热门
传输方式: stdio（本地进程）
运行环境: Python 3.11+ · Docker
凭据: 需要 API Key / 凭据
许可证: Apache-2.0
最近提交: 7 个月前 ⚠
工具数: 1

51FMRS · D

由 Hummingbot 官方维护的 MCP 服务器，通过 stdio 连接 Claude 和 Gemini CLI，提供账户、订单、仓位、市场数据和 Bot 管理工具。文档详尽，支持 uv 与 Docker 部署，错误提示清晰，但仅适用于已具备 Hummingbot 基础设施的用户。

最强项 · 文档质量 14/20 最弱项 · 安全与权限 6/20

可靠性

9/20

安全与权限

6/20

维护活跃度

10/20

文档质量

14/20

安装易用性

12/20

查看各项评分依据

可靠性 9/20: server.json 声明了单一 OCI 包、stdio 传输和三个环境变量，版本号（1.0.4）在包与顶层保持一致，README 也描述了具体的错误处理逻辑（401 不重试、连接失败重试等），显示出一定的工程严谨性。但没有提供可核验的工具清单（README 仅按类别笼统列出'账户管理''下单''持仓管理'等，未给出具体工具名/参数/返回结构），无法核实声明的工具与实际行为是否一致；也未见 CI 工作流或随仓库提交的测试文件作为静态证据（仅 README 提到可运行 uv run pytest，但未展示测试内容）。按静态核查规则，在缺乏可验证的执行证据时可靠性不得超过 12 分，故给出中等偏低分数。
安全与权限 6/20: 凭据通过环境变量传入，用户名/密码在 manifest 中被正确标记为 isSecret，且未在文档中出现明文令牌，这是加分项。但该服务器控制真实资金的自动化交易（下单、持仓管理、机器人部署),权限范围很广，而全部材料中没有任何关于危险操作前确认、模拟/dry-run 模式、操作范围限制或速率限制的说明，也没有权限分级机制。对于可执行真实资金操作的系统，这种确认与最小权限证据的缺失是严重的安全隐患，虽不构成明确坐实的红线（未发现文档明确声明'默认无确认自动下单执行'字样），但风险接近红线水平，因此评分偏低。
维护活跃度 10/20: 许可证为 Apache-2.0，仓库未被归档，版本号 1.0.4 暗示已经过多轮迭代发布，具备基本的持续维护迹象。但提供的材料中没有可查的提交历史、发布节奏、issue 响应时间或安全响应渠道信息，也未见依赖更新记录，因此难以判断维护治理的成熟度，只能给出中等分数。
文档质量 14/20: README 内容详实，涵盖 uv 与 Docker 两种安装方式、docker-compose 云部署示例、环境变量表格、configure_server 工具用法示例以及专门的故障排查章节，层次清晰，示例可操作性强。但缺少各个具体工具的参数级说明（仅按功能分类列出）、没有费用/速率限制说明，也未披露数据使用边界或已知局限性，因此未达满分。
安装易用性 12/20: 安装步骤清晰、覆盖 uv 本地运行、Docker 单容器和 docker-compose 全栈部署三种路径，并给出了 Claude Code/Gemini CLI 的具体配置 JSON 示例，主流客户端兼容性说明较好。但整体设置并不简单：依赖一个独立运行的 Hummingbot API 服务，Docker 网络配置因操作系统而异（Linux 用 --network host，Mac/Windows 用 host.docker.internal），云部署方案还需要额外部署 Postgres、EMQX 等多个服务，属于中等复杂度的人工搭建流程。按静态核查规则，在没有 CI/测试等可验证执行证据时，安装易用性不得超过 15 分，故给出中等分数。

静态评测 · 未实际运行收录于 2026-09-07

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络修改第三方账户数据

适合谁

已运行 Hummingbot API 并希望用 AI 客户端控制交易的用户
熟悉 Docker/uv 配置的加密货币交易者

不适合谁

不使用 Hummingbot 或无运行中 API 服务器的用户
无交易技术背景、不能承受自动化交易风险的初学者

所需权限

需要 Hummingbot API 用户名和密码（HUMMINGBOT_USERNAME、HUMMINGBOT_PASSWORD）
需要可访问的 Hummingbot API 地址（HUMMINGBOT_API_URL）
Docker 部署时会挂载 ~/.hummingbot_mcp 目录保存配置

风险与副作用

该服务器可执行真实交易下单操作，配置错误可能导致资金损失
API 凭据以环境变量和 .env 文件形式存储，需妥善保护
连接到错误 URL 或公开暴露 API 可能带来安全风险

安装接入

准备工作

运行环境：Python 3.11+ · Docker

HUMMINGBOT_API_URL 必填 Hummingbot API 的基础地址（如 http://localhost:8000），仅首次运行用于生成默认配置，Docker 中 Mac/Windows 用 host.docker.internal。

HUMMINGBOT_USERNAME 必填密钥 Hummingbot API 的用户名，仅首次运行用于初始配置。

HUMMINGBOT_PASSWORD 必填密钥 Hummingbot API 的密码（敏感信息），仅首次运行用于初始配置。

其他可选配置项（4 个）

HUMMINGBOT_TIMEOUT 可选连接超时秒数，默认 30.0。

HUMMINGBOT_MAX_RETRIES 可选最大重试次数，默认 3。

HUMMINGBOT_RETRY_DELAY 可选重试间隔秒数，默认 2.0。

HUMMINGBOT_LOG_LEVEL 可选日志级别（DEBUG/INFO/WARNING/ERROR/CRITICAL），默认 INFO。

1) uv 方式：安装 uv，克隆 https://github.com/hummingbot/mcp，运行 uv sync，复制 .env.example 为 .env 并填入 HUMMINGBOT_API_URL、HUMMINGBOT_USERNAME、HUMMINGBOT_PASSWORD，然后在客户端配置中以 uv 运行 main.py。2) Docker 方式：创建 .env，拉取 hummingbot/hummingbot-mcp:latest，Linux 上加 --network host，Mac/Windows 上将 API URL 改为 http://host.docker.internal:8000，再在客户端配置 docker run 命令。也可用 Docker Compose 与 hummingbot-api、emqx、postgres 一同部署。要求 Python 3.11+ 且 Hummingbot API 正在运行。

.mcp.json

{"mcpServers":{"hummingbot-mcp":{"type":"stdio","command":"uv","args":["--directory","/path/to/mcp","run","main.py"]}}}

以 Claude Code 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "hummingbot-mcp": {
      "type": "stdio",
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/mcp",
        "run",
        "main.py"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add hummingbot-mcp -- uv --directory /path/to/mcp run main.py

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在客户端工具列表中应出现 configure_server 工具；不带参数调用 configure_server 可查看当前连接的 Hummingbot API 配置，能返回即证明连接正常。

常见排障

收到“Cannot reach Hummingbot API”提示时，确认 API 服务器正在运行且 URL 可访问
认证失败（401）说明用户名或密码错误，请用 configure_server 更新凭据
Mac/Windows Docker 环境应使用 host.docker.internal 而非 localhost
Linux Docker 部署需加 --network host 以访问宿主机 API

试试这样问

连接成功后，可以直接对 AI 助手这样说：

显示当前的 Hummingbot 服务器配置
把 Hummingbot API 的主机改为 192.168.1.100，端口改为 8001
更新 Hummingbot API 的用户名为 admin，密码为 secure_password
查看我的投资组合余额分布

工具能力 1

configure_server 写入

查看或更新当前 Hummingbot API 服务器连接配置（主机、端口、凭据），更新后自动重连，配置持久化于 ~/.hummingbot_mcp/server.yml

使用场景

通过 Claude 或 Gemini CLI 下单、管理仓位与查询账户余额

获取价格、订单簿、K 线和资金费率等市场数据

部署和管理 Hummingbot 交易机器人及控制器配置

使用 Docker Compose 在云端部署 MCP 服务器与 Hummingbot API

支持客户端

Claude Code

Gemini CLI

依据项目文档列出，未经本站实测。

详细介绍

Hummingbot MCP Server 是一个 Model Context Protocol 服务器，让 Claude 和 Gemini CLI 能够与 Hummingbot API 交互，进行跨多个交易所的自动化加密货币交易。它由 Hummingbot 官方维护，提供账户管理、订单与仓位管理、市场数据、资金费率、Bot 部署和控制器配置等工具，支持通过 uv 本地运行或 Docker 部署，并可使用 Docker Compose 在云端与 Hummingbot API 一同部署。