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）
分析资产分布与配置

📊 订单管理¶

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

📈 持仓管理¶

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

🔍 市场数据访问¶

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

📉 资金费率监控¶

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

🌐 网关与去中心化交易所（DEX）交易¶

管理网关容器的生命周期（启动、停止、重启）
配置链、网络、代币和钱包
在 DEX 路由器（Jupiter、0x）上执行兑换交易
发现并分析 CLMM（集中流动性）资金池
开启并管理流动性头寸
从活跃头寸中收取费用

🔄 多服务器支持¶

同时连接多个 Hummingbot API 实例
在不同环境（生产、预发布、开发）中管理交易
在对话中无缝切换服务器
统一界面实现多实例投资组合管理

架构¶

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 助手配合使用¶

Hummingbot MCP 服务器可与多种 AI 助手协同工作。有关以下工具的详细安装说明，请参阅 安装指南：

Claude Code（命令行工具）—— 推荐开发者使用
Claude Desktop —— 图形化桌面应用
Gemini CLI —— Google 的 AI 助手
Codex CLI —— OpenAI 的编程助手

交易对话示例¶

配置完成后，你可以自然地与你的 AI 助手进行交互：

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

示例工作流¶

投资组合分析¶

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

使用 Claude Code 与 Hummingbot 构建 AI 加密交易代理¶

AMA：Hummingbot API + MCP¶