Hummingbot MCP 服务器安装指南¶

本指南将引导您完成 Hummingbot MCP 服务器 的安装与配置，将其与 Claude CLI、Gemini CLI 或 Codex CLI 等 AI 助手连接，并解决常见问题。

📋 前置条件¶

开始前，请确保已准备以下内容：

1. 已安装 Python 3.11+
2. Hummingbot API 服务器 正在运行（安装指南）
3. 拥有 有效的 Hummingbot API 凭据
4. 一个 兼容 MCP 的 AI 助手（例如 Claude CLI、Gemini CLI、Codex CLI）
5. 已安装并运行 Docker Desktop

💡 提示： 请确保 Docker Desktop 已启用 MCP Toolkit 功能。

⚙️ 通过 Docker MCP 目录安装¶

打开 Docker Desktop → 导航至 MCP Toolkit → 目录。
搜索 Hummingbot MCP 服务器 并点击 ➕ 安装。

进入已安装服务器的 配置 选项卡。

设置以下环境变量：

输入您的值后，勾选右侧复选框 以保存。

🔗 连接 MCP 客户端¶

服务器配置完成后，将其与您的 MCP 客户端连接：

在 Docker Desktop → MCP Toolkit → 客户端 中

选择您的 AI 客户端（例如 Claude Desktop、Cursor、VS Code）。
点击 连接 以建立链接。

对于未列出的客户端，您可以：

• 手动运行 MCP 网关：

  docker mcp gateway run
  

• 或在客户端配置中手动添加服务器：

"mcp": {
  "servers": {
    "MCP_DOCKER": {
      "command": "docker",
      "args": ["mcp", "gateway", "run"],
      "type": "stdio"
    }
  }
}

🛠️ JSON MCP 集成¶

Gemini CLI¶

Gemini CLI 是 Google 开源的 AI 代理，可将 Gemini 模型集成到您的终端中。

安装¶

👉 Gemini CLI 安装指南

配置¶

导航至配置文件夹：

cd ~/.gemini

编辑 settings.json 文件

nano settings.json

添加 MCP 服务器配置：

{
  "mcpServers": {
    "hummingbot-mcp": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "--network", "host",
        "-e", "HUMMINGBOT_API_URL",
        "-e", "HUMMINGBOT_USERNAME",
        "-e", "HUMMINGBOT_PASSWORD",
        "hummingbot/hummingbot-mcp:latest"
      ],
      "env": {
        "HUMMINGBOT_API_URL": "http://localhost:8000",
        "HUMMINGBOT_USERNAME": "admin",
        "HUMMINGBOT_PASSWORD": "admin"
      }
    }
  }
}

打开 Gemini 并通过运行以下命令验证连接：

/mcp list

✅ 您应在输出中看到 hummingbot-mcp。

Codex CLI¶

Codex CLI 是 OpenAI 为开发者工作流设计的本地编码代理。

安装¶

👉 Codex CLI 安装指南

配置¶

导航至配置文件夹：

cd ~/.codex

编辑 config.toml：

nano config.toml

添加 MCP 服务器配置：

[mcp_servers.hummingbot-mcp]
command = "docker"
args = [
  "run", "-i", "--rm",
  "--network", "host",
  "-e", "HUMMINGBOT_API_URL",
  "-e", "HUMMINGBOT_USERNAME",
  "-e", "HUMMINGBOT_PASSWORD",
  "hummingbot/hummingbot-mcp:latest"
]

[mcp_servers.hummingbot-mcp.env]
HUMMINGBOT_API_URL = "http://localhost:8000"
HUMMINGBOT_USERNAME = "admin"
HUMMINGBOT_PASSWORD = "admin"

运行 Codex 并通过执行以下命令验证连接：

/mcp

✅ Codex 现在应能检测并连接到 Hummingbot MCP 服务器。

🤖 使用 AI 助手测试¶

配置完成后，尝试以下命令：

• “显示我的投资组合余额”

• “列出所有活跃的交易机器人”

• “获取 Binance 上 BTC-USDT 的当前价格”

🐛 故障排除¶

连接问题¶

• 确保 Hummingbot API 服务器 正在运行。
• 仔细检查 HUMMINGBOT_API_URL。
• 如果在 Docker 中运行 Hummingbot，请在 Mac/Windows 上使用 host.docker.internal 替代 localhost。
• 确认您的 Docker 环境支持 --network host。
• 验证端口号是否与您的 Hummingbot API 配置一致。

身份验证错误¶

• 核对 API 凭据（用户名/密码）。
• 如适用，请检查您的 .env 文件。
• 确保凭据已保存在 Docker Desktop 中。

🚀 下一步¶

安装完成后：

1. 探索 MCP 工具
2. 查看 示例工作流
3. 查阅 安全指南

📢 需要帮助？ 加入我们的 Discord 社区 或访问 GitHub 仓库 获取最新更新。