适合谁
- 已运行 Hummingbot API 并希望用 AI 客户端控制交易的用户
- 熟悉 Docker/uv 配置的加密货币交易者
H
51FMRS · D
由 Hummingbot 官方维护的 MCP 服务器，通过 stdio 连接 Claude 和 Gemini CLI，提供账户、订单、仓位、市场数据和 Bot 管理工具。文档详尽，支持 uv 与 Docker 部署，错误提示清晰，但仅适用于已具备 Hummingbot 基础设施的用户。
Hummingbot MCP Server 是一个 Model Context Protocol 服务器，让 Claude 和 Gemini CLI 能够与 Hummingbot API 交互，进行跨多个交易所的自动化加密货币交易。它由 Hummingbot 官方维护，提供账户管理、订单与仓位管理、市场数据、资金费率、Bot 部署和控制器配置等工具，支持通过 uv 本地运行或 Docker 部署，并可使用 Docker Compose 在云端与 Hummingbot API 一同部署。
工具能力
configure_server
查看或更新当前 Hummingbot API 服务器连接配置（主机、端口、凭据），更新后自动重连，配置持久化于 ~/.hummingbot_mcp/server.yml
安装接入
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 正在运行。
claude_desktop_config.json
{"mcpServers":{"hummingbot-mcp":{"type":"stdio","command":"uv","args":["--directory","/path/to/mcp","run","main.py"]}}}
选型与风险
不适合谁
- 不使用 Hummingbot 或无运行中 API 服务器的用户
- 无交易技术背景、不能承受自动化交易风险的初学者
所需权限
- 需要 Hummingbot API 用户名和密码（HUMMINGBOT_USERNAME、HUMMINGBOT_PASSWORD）
- 需要可访问的 Hummingbot API 地址（HUMMINGBOT_API_URL）
- Docker 部署时会挂载 ~/.hummingbot_mcp 目录保存配置
风险与副作用
- 该服务器可执行真实交易下单操作，配置错误可能导致资金损失
- API 凭据以环境变量和 .env 文件形式存储，需妥善保护
- 连接到错误 URL 或公开暴露 API 可能带来安全风险
常见排障
- 收到“Cannot reach Hummingbot API”提示时，确认 API 服务器正在运行且 URL 可访问
- 认证失败（401）说明用户名或密码错误，请用 configure_server 更新凭据
- Mac/Windows Docker 环境应使用 host.docker.internal 而非 localhost
- Linux Docker 部署需加 --network host 以访问宿主机 API
使用场景
通过 Claude 或 Gemini CLI 下单、管理仓位与查询账户余额
获取价格、订单簿、K 线和资金费率等市场数据
部署和管理 Hummingbot 交易机器人及控制器配置
使用 Docker Compose 在云端部署 MCP 服务器与 Hummingbot API
支持客户端
Claude Code完整支持
Gemini CLI完整支持