Hummingbot MCP 服务器¶

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

GitHub 仓库： github.com/hummingbot/mcp

概述¶

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

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

模型上下文协议是一种开放标准，使 AI 助手能够安全地与外部系统和数据源交互。在 Hummingbot 的语境中，MCP 使 AI 模型能够：

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

核心功能¶

Hummingbot MCP 服务器提供以下功能：

🏦 账户管理¶

连接和管理多个交易所账户
获取账户信息和凭证
监控各交易所的账户状态

💰 资产组合追踪¶

查看所有已连接交易所的实时余额
追踪投资组合表现与盈亏（P&L）
分析资产分布与配置

📊 订单管理¶

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

📈 持仓管理¶

追踪衍生品交易的未平仓头寸
监控头寸规模与未实现盈亏
编程式平仓

🔍 市场数据访问¶

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

📉 资金费率监控¶

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

架构¶

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¶

按照Anthropic 的指南安装 Claude CLI

在 Claude 配置中配置 MCP 服务器：

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

开始交易对话：

You: Show me my portfolio balances across all exchanges
Claude: I'll check your portfolio balances using the Hummingbot MCP server...

Gemini CLI¶

Gemini CLI 的配置流程——请参阅 Google 的文档了解 MCP 设置，或查看Gemini CLI 安装指南

示例工作流¶

投资组合分析¶

AI: "What's my current portfolio worth and how is it distributed?"
MCP: Retrieves balances across all exchanges and calculates total value
AI: Provides detailed breakdown with recommendations

自动化交易¶

AI: "Buy 0.1 BTC when the price drops below $45,000"
MCP: Monitors prices and executes order when conditions are met
AI: Confirms execution and provides trade summary

风险管理¶

AI: "Close all positions with unrealized losses over 5%"
MCP: Analyzes open positions and closes those meeting criteria  
AI: Reports actions taken and updated portfolio status

OpenAI Codex¶

设置方法请参见Codex CLI 安装指南

AMA：Hummingbot API + MCP¶