MCP Server

Use This MCP server To

Automate cryptocurrency trades across multiple exchanges Monitor and control Hummingbot trading bots via AI Send trading commands from Claude or Gemini AI apps Deploy Hummingbot trading automation in cloud or local setups Configure AI to interact with Hummingbot API securely Manage multiple exchange strategies through AI commands

README

MCP Hummingbot Server

An MCP (Model Context Protocol) server that enables Claude and Gemini CLI to interact with Hummingbot for automated cryptocurrency trading across multiple exchanges.

Installation & Configuration

Option 1: Using uv (Recommended for Development)

Install uv (if not already installed):

curl -LsSf https://astral.sh/uv/install.sh | sh

Clone and install dependencies:

git clone https://github.com/hummingbot/mcp
cd mcp
uv sync

Create a .env file:
```
cp .env.example .env
```

Edit the .env file with your Hummingbot API credentials:

HUMMINGBOT_API_URL=http://localhost:8000
HUMMINGBOT_USERNAME=admin
HUMMINGBOT_PASSWORD=admin

Configure in Claude Code or Gemini CLI:

{
  "mcpServers": {
    "hummingbot-mcp": {
      "type": "stdio",
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/mcp",
        "run",
        "main.py"
      ]
    }
  }
}

Note: Make sure to replace /path/to/mcp with the actual path to your MCP directory.

Option 2: Using Docker (Recommended for Production)

mcp FAQ

Can I use this to automate cryptocurrency trading across multiple exchanges?

Yes — this MCP server connects your AI assistant to Hummingbot, enabling automated trading commands across exchanges.

Does this work with Claude and Gemini AI apps?

Yes — it is designed to integrate with Claude Desktop and Gemini CLI for trading tasks.

Do I need a Hummingbot account or API credentials?

Yes — you must have a running Hummingbot API server and valid API credentials to use this server.

How hard is it to set up this MCP server?

It requires developer-level setup including Python 3.11+, Docker or command-line tools, and configuration files.

Can I run this server using Docker?

Yes — Docker images are provided for easy deployment in production or cloud environments.

Is an API key required for the AI model providers?

No — this server connects your AI to Hummingbot; model API keys are managed separately in your AI app.

Which operating systems are supported?

Linux, Mac, and Windows are supported with specific Docker networking instructions for each.

Can I use this MCP server without coding?

No — some command-line and configuration editing is needed, so it's best for users comfortable with developer tools.