Hummingbot MCP 服务器¶

Hummingbot 模型上下文协议（MCP）服务器使 Claude 和 Gemini 等 AI 助手能够与 Hummingbot 交互，以在多个交易所进行自动化加密货币交易。

GitHub 仓库: github.com/hummingbot/mcp

概述¶

MCP 服务器充当 AI 语言模型和 Hummingbot 交易平台之间的桥梁，使程序化交互加密货币交易基础设施成为可能。这使得 AI 助手能够代表用户管理交易操作、分析投资组合和执行策略。

教程视频¶

第一部分：Hummingbot MCP 服务器简介¶

第二部分：构建 AI 交易代理¶

什么是模型上下文协议（MCP）？¶

模型上下文协议是一个开放标准，允许 AI 助手安全地与外部系统和数据源进行交互。在 Hummingbot 的上下文中，MCP 允许 AI 模型：

访问实时交易数据
执行交易操作
管理多个交易所的投资组合
分析市场状况
监控交易表现

主要特性¶

Hummingbot MCP 服务器提供了以下能力：

🏦 账户管理¶

连接和管理多个交易所账户
检索账户信息和凭证
监控跨交易所的账户状态

💰 投资组合追踪¶

查看所有连接交易所的实时余额
跟踪投资组合表现和盈亏
分析资产分布和分配

📊 订单管理¶

在任何支持的交易所下买单和卖单
取消现有订单
监控订单状态和执行
查看订单历史和成交记录

📈 仓位管理¶

跟踪衍生品交易的开放仓位
监控仓位规模和未实现盈亏
以编程方式关闭仓位

🔍 市场数据访问¶

检索实时价格数据
访问订单簿信息
获取历史价格数据
监控永续合约的资金费率

📉 资金费率监控¶

跟踪永续交易所的资金费率
识别套利机会
监控资金费率随时间的变化

架构¶

graph TB
    subgraph "AI Assistants"
        CLAUDE[Claude CLI]
        GEMINI[Gemini CLI]
    end

    subgraph "MCP Server"
        MCP[Hummingbot<br/>MCP Server]
    end

    subgraph "Hummingbot Infrastructure" 
        API[Hummingbot API<br/>Server]
        BOTS[Trading Bots]
    end

    subgraph "Exchanges"
        EX[Binance, OKX,<br/>Hyperliquid, etc.]
    end

    %% AI to MCP connections
    CLAUDE -->|MCP Protocol| MCP
    GEMINI -->|MCP Protocol| MCP

    %% MCP to Hummingbot API
    MCP -->|REST API| API

    %% API to infrastructure
    API <--> BOTS
    BOTS <--> EX
    API <--> EX

    %% Styling
    classDef aiStyle stroke:#5FFFD7,stroke-width:3px
    classDef mcpStyle stroke:#E549FF,stroke-width:3px  
    classDef hbStyle stroke:#00B1BB,stroke-width:3px

    class CLAUDE,GEMINI aiStyle
    class MCP mcpStyle
    class API,BOTS hbStyle

开始使用¶

准备好使用 Hummingbot 构建 AI 交易代理了吗？请按照以下步骤操作：

安装 MCP 服务器 - 设置开发或生产环境
探索可用工具 - 了解交易和投资组合管理功能
配置您的 AI 助手 - 连接 Claude、Gemini 或其他 MCP 兼容的 AI
开始交易对话 - 让 AI 自动管理您的投资组合

快速概览¶

MCP 服务器通过以下工具类别提供全面的交易能力：

🏦 账户和投资组合管理¶

监控余额、跟踪表现，并分析所有连接交易所的投资组合分配情况。

📊 订单和仓位管理¶

以编程方式执行交易、管理订单，并在 AI 监督下控制仓位。

📈 市场数据和分析¶

访问实时价格、资金费率和订单簿数据，以进行明智的决策。

与 AI 助手的使用¶

Claude CLI¶

安装 Claude CLI 遵循 Anthropic 的指南

在您的 Claude 配置中配置 MCP 服务器:

{
  "mcpServers": {
    "hummingbot": {
      "command": "uv",
      "args": ["run", "mcp"],
      "cwd": "/path/to/hummingbot-mcp"
    }
  }
}

开始交易对话:

您: 显示我在所有交易所的投资组合余额
Claude: 我将使用 Hummingbot MCP 服务器检查您的投资组合余额...

Gemini CLI¶

类似 Gemini CLI 的配置流程 - 请参考 Google 的 MCP 设置文档。

示例工作流¶

投资组合分析¶

AI: "我当前的投资组合价值多少，如何分配？"
MCP: 在所有交易所中检索余额并计算总价值
AI: 提供详细分析并给出建议

自动交易¶

AI: "当价格跌破 45,000 美元时买入 0.1 BTC"
MCP: 监控价格并在条件满足时执行订单
AI: 确认执行并提供交易摘要

风险管理¶

AI: "关闭所有未实现亏损超过 5% 的头寸"
MCP: 分析开放头寸并关闭符合条件的头寸
AI: 报告采取的行动和更新后的投资组合状态

安全注意事项¶

API 凭据: 安全存储凭据，切勿将其提交到版本控制系统
网络访问: 确保 MCP 服务器仅可由授权的 AI 助手访问
交易限制: 在策略中设置适当的头寸规模和风险限制
监控: 定期监控 AI 交易活动并对异常行为设置警报

开发¶

贡献¶

Hummingbot MCP 服务器是开源的。欢迎贡献！

派生仓库
创建功能分支
进行更改
为新功能添加测试
提交拉取请求

自定义工具¶

您可以通过添加自定义工具来扩展 MCP 服务器：

 @mcp.tool()
async def my_custom_tool(parameter: str) -> str:
    """自定义工具描述"""
    # 您的实现代码在此处
    return result