MCP

🚀 MCP Hummingbot Server

MCP（Model Context Protocol）サーバーです。ClaudeとGemini CLIがHummingbotとやり取りし、複数の取引所で自動暗号通貨取引を行えるようにします。

🚀 クイックスタート

MCP Hummingbot Serverを使用することで、ClaudeやGemini CLIを通じてHummingbotとの自動暗号通貨取引が可能になります。以下に、インストール、設定、管理の手順を説明します。

✨ 主な機能

• 複数のHummingbot APIサーバーを管理できます。
• 取引やアカウント管理のツールを提供します。
• 包括的なエラーメッセージで接続や認証の問題を診断しやすくなっています。

📦 インストール

オプション1: uvを使用する（開発用に推奨）

1. uvをインストールする（まだインストールされていない場合）:

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

2. リポジトリをクローンし、依存関係をインストールする:

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

3. .envファイルを作成する:

   cp .env.example .env
   

4. .envファイルを編集し、Hummingbot APIの資格情報を設定する:

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

5. Claude CodeまたはGemini CLIで設定する:

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

   注意: /path/to/mcp を実際のMCPディレクトリのパスに置き換えてください。

オプション2: Dockerを使用する（本番用に推奨）

1. .envファイルを作成する:

   touch .env
   

2. .envファイルを編集し、Hummingbot APIの資格情報を設定する:

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

   重要: DockerでMCPサーバーを実行し、ホストのHummingbot APIに接続する場合:

   • Linux: --network host を使用して（以下を参照）、コンテナが localhost:8000 にアクセスできるようにします。
   • Mac/Windows: HUMMINGBOT_API_URL を http://host.docker.internal:8000 に変更します。

3. Dockerイメージを取得する:

   docker pull hummingbot/hummingbot-mcp:latest
   

4. Claude CodeまたはGemini CLIで設定する:

   Linuxの場合（--network hostを使用）:

   {
     "mcpServers": {
       "hummingbot-mcp": {
         "type": "stdio",
         "command": "docker",
         "args": [
           "run",
           "--rm",
           "-i",
           "--network",
           "host",
           "--env-file",
           "/path/to/mcp/.env",
           "-v",
           "$HOME/.hummingbot_mcp:/root/.hummingbot_mcp",
           "hummingbot/hummingbot-mcp:latest"
         ]
       }
     }
   }
   

   Mac/Windowsの場合:

   {
     "mcpServers": {
       "hummingbot-mcp": {
         "type": "stdio",
         "command": "docker",
         "args": [
           "run",
           "--rm",
           "-i",
           "--env-file",
           "/path/to/mcp/.env",
           "-v",
           "$HOME/.hummingbot_mcp:/root/.hummingbot_mcp",
           "hummingbot/hummingbot-mcp:latest"
         ]
       }
     }
   }
   

   （.env ファイルで HUMMINGBOT_API_URL=http://host.docker.internal:8000 を設定することを忘れないでください）

   注意: /path/to/mcp を実際のMCPディレクトリのパスに置き換えてください。

Docker Composeを使用したクラウドデプロイメント

Hummingbot APIとMCPサーバーが同じサーバー上で実行されるクラウドデプロイメントの場合:

1. .envファイルを作成する:

   touch .env
   

2. .envファイルを編集し、Hummingbot APIの資格情報を設定する:

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

3. docker-compose.ymlを作成する:

   services:
     hummingbot-api:
       container_name: hummingbot-api
       image: hummingbot/hummingbot-api:latest
       ports:
         - "8000:8000"
       volumes:
         - ./bots:/hummingbot-api/bots
         - /var/run/docker.sock:/var/run/docker.sock
       environment:
         - USERNAME=admin
         - PASSWORD=admin
         - BROKER_HOST=emqx
         - DATABASE_URL=postgresql+asyncpg://hbot:hummingbot-api@postgres:5432/hummingbot_api
       networks:
         - emqx-bridge
       depends_on:
         - postgres
   
     mcp-server:
       container_name: hummingbot-mcp
       image: hummingbot/hummingbot-mcp:latest
       stdin_open: true
       tty: true
       env_file:
         - .env
       environment:
         - HUMMINGBOT_API_URL=http://hummingbot-api:8000
       depends_on:
         - hummingbot-api
       networks:
         - emqx-bridge
   
     # hummingbot-api docker-compose.ymlの他のサービスを必要に応じて含める
     emqx:
       container_name: hummingbot-broker
       image: emqx:5
       restart: unless-stopped
       environment:
         - EMQX_NAME=emqx
         - EMQX_HOST=node1.emqx.local
         - EMQX_CLUSTER__DISCOVERY_STRATEGY=static
         - EMQX_CLUSTER__STATIC__SEEDS=[emqx@node1.emqx.local]
         - EMQX_LOADED_PLUGINS="emqx_recon,emqx_retainer,emqx_management,emqx_dashboard"
       volumes:
         - emqx-data:/opt/emqx/data
         - emqx-log:/opt/emqx/log
         - emqx-etc:/opt/emqx/etc
       ports:
         - "1883:1883"
         - "8883:8883"
         - "8083:8083"
         - "8084:8084"
         - "8081:8081"
         - "18083:18083"
         - "61613:61613"
       networks:
         emqx-bridge:
           aliases:
             - node1.emqx.local
       healthcheck:
         test: [ "CMD", "/opt/emqx/bin/emqx_ctl", "status" ]
         interval: 5s
         timeout: 25s
         retries: 5
   
     postgres:
       container_name: hummingbot-postgres
       image: postgres:15
       restart: unless-stopped
       environment:
         - POSTGRES_DB=hummingbot_api
         - POSTGRES_USER=hbot
         - POSTGRES_PASSWORD=hummingbot-api
       volumes:
         - postgres-data:/var/lib/postgresql/data
       ports:
         - "5432:5432"
       networks:
         - emqx-bridge
       healthcheck:
         test: ["CMD-SHELL", "pg_isready -U hbot -d hummingbot_api"]
         interval: 10s
         timeout: 5s
         retries: 5
   
   networks:
     emqx-bridge:
       driver: bridge
   
   volumes:
     emqx-data: { }
     emqx-log: { }
     emqx-etc: { }
     postgres-data: { }
   

4. デプロイする:

   docker compose up -d
   

5. 既存のコンテナに接続するようにClaude CodeまたはGemini CLIを設定する:

   {
     "mcpServers": {
       "hummingbot-mcp": {
         "type": "stdio",
         "command": "docker",
         "args": [
           "exec",
           "-i",
           "hummingbot-mcp",
           "uv",
           "run",
           "main.py"
         ]
       }
     }
   }
   

   注意: hummingbot-mcp を実際のコンテナ名に置き換えてください。コンテナ名は以下のコマンドで確認できます:

   docker ps
   

複数のAPIサーバーの管理

MCPサーバーは現在、複数のHummingbot APIサーバーを管理できるようになっています。これは、複数のデプロイメントや環境がある場合に便利です。

初期設定

初回実行時に、サーバーは環境変数からデフォルトサーバーを作成します（または、デフォルトの資格情報で http://localhost:8000 を使用します）。設定は ~/.hummingbot_mcp/servers.yml に保存されます。

configure_api_serversツールの使用

# すべての設定済みサーバーをリストする
configure_api_servers()

# 完全なURLを使用して新しいサーバーを追加する
configure_api_servers(
    action="add",
    name="production",
    url="http://prod-server:8000",
    username="admin",
    password="secure_password"
)

# ポートのみを使用してサーバーを追加する（デフォルトはlocalhost）
configure_api_servers(
    action="add",
    name="local_8001",
    port=8001,
    username="admin",
    password="secure_password"
)

# デフォルトポート8000を使用してサーバーを追加する
configure_api_servers(
    action="add",
    name="local_default",
    username="admin",
    password="secure_password"
)

# 別のサーバーに切り替える
configure_api_servers(action="set_default", name="production")

# サーバーを削除する
configure_api_servers(action="remove", name="old_server")

以降のすべてのAPI呼び出しは、現在選択されているデフォルトサーバーを使用します。

環境変数

MCPサーバーの .env ファイルで以下の環境変数を設定できます:

注意: 初期設定後は、configure_api_servers ツールを使用してサーバーを管理してください。環境変数は初期デフォルトサーバーを作成するためにのみ使用されます。

必要条件

• Python 3.11以上
• 実行中のHummingbot APIサーバー
• 有効なHummingbot API資格情報

利用可能なツール

MCPサーバーは以下のツールを提供します:

サーバー管理

• configure_api_servers: 複数のHummingbot APIサーバーの接続を管理します。
  • すべての設定済みサーバーをリストします。
  • 資格情報を持つ新しいサーバーを追加します。
  • デフォルトサーバーを設定します（クライアントを自動的に再接続します）。
  • サーバーを削除します。
  • 設定は ~/.hummingbot_mcp/servers.yml に保存されます。

取引とアカウント管理

• アカウント管理とコネクタの設定
• ポートフォリオの残高と配分
• 注文の配置と管理
• ポジション管理
• 市場データ（価格、オーダーブック、ローソク足）
• 資金レート
• ボットのデプロイと管理
• コントローラーの設定

開発

開発モードでサーバーを実行するには:

uv run main.py

テストを実行するには:

uv run pytest

トラブルシューティング

MCPサーバーは現在、接続や認証の問題を診断するための包括的なエラーメッセージを提供します:

接続エラー

次のようなエラーメッセージが表示された場合:

• ❌ Cannot reach Hummingbot API at <url> - APIサーバーが実行されていないか、アクセスできません。
• ❌ Authentication failed when connecting to Hummingbot API - ユーザー名またはパスワードが間違っています。
• ❌ Failed to connect to Hummingbot API - 一般的な接続失敗。

エラーメッセージには以下が含まれます:

• 使用されている正確なURL
• 設定されたユーザー名（パスワードはマスクされます）
• 問題を解決するための具体的な提案
• configure_api_servers などのツールへの参照

一般的な解決策

1. APIが実行されていない:

   • Hummingbot APIサーバーが実行されていることを確認してください。
   • 設定されたURLでAPIにアクセスできることを確認してください。

2. 資格情報が間違っている:

   • configure_api_servers ツールを使用してサーバーの資格情報を更新してください。
   • または、.env ファイルの設定を確認してください。

3. URLが間違っている:

   • configure_api_servers ツールを使用してサーバーのURLを更新してください。
   • Mac/WindowsのDockerでは、localhost の代わりに host.docker.internal を使用してください。

4. Dockerネットワークの問題:

   • Linuxでは、Docker設定で --network host を使用してください。
   • Mac/Windowsでは、API URLとして host.docker.internal:8000 を使用してください。

エラー防止

MCPサーバーは以下のことを行います:

• 認証失敗（401エラー）では再試行しません - 資格情報が間違っていることをすぐに通知します。
• 接続失敗では再試行します。何が問題なのかについて役立つメッセージを表示します。
• Dockerで実行しているかどうかのコンテキストを提供します。適切な解決策を提案します。
• 問題を解決するために適切なツール（configure_api_servers）に案内します。