MCP 服务器安装¶

本指南涵盖了 Hummingbot MCP 服务器在不同环境和用例下的安装和设置。

先决条件¶

在安装 Hummingbot MCP 服务器之前，请确保您具备：

1. 系统上已安装 Python 3.11+
2. 正在运行的 Hummingbot API 服务器 - 参见 Hummingbot API 安装
3. Hummingbot API 服务器的 有效 API 凭据
4. 支持 MCP 的 AI 助手（Claude CLI、Gemini CLI 等）
5. 已安装 Docker Desktop

Docker MCP 目录¶

• 打开 Docker Desktop，转到 "MCP Toolkit" > "Catalog"。

• 浏览或搜索 Hummingbot MCP 服务器

• 点击加号图标安装 Hummingbot MCP 服务器

• 导航到 Hummingbot MCP 服务器的 "Configuration" 选项卡

• 为 MCP 服务器连接 Hummingbot API 设置以下 环境变量：

输入用户名和密码后，请确保点击行末的复选框以在 Docker Desktop UI 中保存更改。

连接 MCP 客户端¶

• 安装并配置 Hummingbot MCP 服务器后，您可以将其连接到 MCP 客户端

• 在 Docker Desktop 中，选择 MCP Toolkit 并选择 Clients 选项卡

• 找到您希望连接的客户端（例如 Claude Desktop、Cursor、VS Code）。

• 点击 "Connect" 建立连接。

对于未列出的其他客户端，您可以通过指定以下命令连接它们：

docker mcp gateway run

或者 手动将 Docker MCP Toolkit 添加为服务器

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

JSON MCP 集成¶

• 如果您没有安装 Docker Desktop（仅限 Linux CLI），则可以通过将以下内容添加到 AI 助手的 mcp.json 文件中来手动添加 Hummingbot MCP。

• 请注意，您仍然需要让 docker 正常工作。

{
  "mcpServers": {
    "hummingbot-mcp-docker": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--network", "host",
        "-e", "HUMMINGBOT_API_URL=http://localhost:8000",
        "-e", "HUMMINGBOT_USERNAME=admin",
        "-e", "HUMMINGBOT_PASSWORD=admin",
        "hummingbot/hummingbot-mcp:latest"
      ],
      "description": "Hummingbot MCP server for interacting with Hummingbot API"
    }
  }
}

可选配置¶

使用 AI 助手测试¶

与您的 AI 助手开始对话：

You: "Can you show me my portfolio balances?"
AI: "I'll check your portfolio balances using the Hummingbot MCP server..."

故障排除¶

连接问题¶

1. API 服务器无法访问 - 验证 Hummingbot API 服务器正在运行 - 检查配置中的 API URL - 测试网络连接

2. 认证失败 - 验证提供的用户名/密码或 .env 文件中的凭据 - 检查 API 服务器认证设置 - 确保凭据格式正确

下一步¶

安装成功后：

1. 探索 MCP 工具 - 了解可用的交易工具
2. 查看 使用示例 - 查看实用的 AI 交易工作流程
3. 审查 安全指南 - 确保安全运行

如需更多支持，请访问我们的 Discord 社区 或查看 GitHub 仓库 获取最新更新。