Freqtrade-MCP

Freqtrade-MCP

Freqtrade 暗号資産取引ボットと REST API 経由で連携する MCP サーバーです。自動取引の操作で AI エージェントをシームレスに利用できます。

暗号資産関連の MCP サーバーについては、Kukapay MCP serversをご覧ください。

インストール

前提条件

• Python 3.13+：システムに Python がインストールされていることを確認してください。
• Freqtrade：REST API を有効にした、実行中の Freqtrade インスタンス（Freqtrade ドキュメントを参照）。
• Git：リポジトリのクローンに使用します。

手順

1. リポジトリをクローンする：

   git clone https://github.com/kukapay/freqtrade-mcp.git
   cd freqtrade-mcp
   

2. 依存関係をインストールする： pip を使用する場合：

   pip install freqtrade-client mcp[cli]
   

   または uv を使用する場合（任意）：

   uv add freqtrade-client "mcp[cli]"
   

3. クライアントの設定：

   "mcpServers": { 
     "freqtrade-mcp": { 
       "command": "uv", 
       "args": [ 
         "--directory", "/your/path/to/freqtrade-mcp", 
         "run", 
         "__main__.py" 
       ], 
       "env": { 
          "FREQTRADE_API_URL": "http://127.0.0.1:8080",
          "FREQTRADE_USERNAME": "your_username",
          "FREQTRADE_PASSWORD": "your_password"
       } 
     } 
   }
   

4. Freqtrade の設定：

   設定に api_server セクションを追加し、api_server.enabled を true に設定して REST API を有効にします。

   設定例：

       "api_server": {
       "enabled": true,
       "listen_ip_address": "127.0.0.1",
       "listen_port": 8080,
       "verbosity": "error",
       "enable_openapi": false,
       "jwt_secret_key": "somethingrandom",
       "CORS_origins": [],
       "username": "Freqtrader",
       "password": "SuperSecret1!",
       "ws_token": "sercet_Ws_t0ken"
   },
   

   ドキュメントはこちらをご確認ください。

使用方法

利用可能なツール

サーバーは、以下の Freqtrade API エンドポイントを MCP ツールとして公開します。

ツール	説明	パラメーター
fetch_market_data	通貨ペアの OHLCV データを取得する	pair: str、timeframe: str
fetch_bot_status	オープントレードのステータスを取得する	なし
fetch_profit	損益の概要を取得する	なし
fetch_balance	アカウント残高を取得する	なし
fetch_performance	パフォーマンス指標を取得する	なし
fetch_whitelist	通貨ペアのホワイトリストを取得する	なし
fetch_blacklist	通貨ペアのブラックリストを取得する	なし
fetch_trades	取引履歴を取得する	なし
fetch_config	ボットの設定を取得する	なし
fetch_locks	取引ロックを取得する	なし
place_trade	買い／売り取引を実行する	pair: str、side: str、stake_amount: float
start_bot	ボットを起動する	なし
stop_bot	ボットを停止する	なし
reload_config	ボットの設定を再読み込みする	なし
add_blacklist	通貨ペアをブラックリストに追加する	pair: str
delete_blacklist	通貨ペアをブラックリストから削除する	pair: str
delete_lock	取引ロックを削除する	lock_id: int

プロンプトの例

1. 市場データの取得：

   • 「BTC/USDT の時間足の価格データを表示してください。」
   • 「ETH/BTC の 5 分足チャートはどのような感じですか？」
   • 「過去 1 時間の XRP/USDT の最新のローソク足データを表示してください。」

2. ボットのステータスの取得：

   • 「現在のオープン中の取引のステータスを教えてください。」
   • 「現在、アクティブな取引はありますか？」
   • 「現在のボットの取引状況について教えてください。」

3. 利益の取得：

   • 「これまでにどれくらいの利益が出ていますか？」
   • 「ボットの利益の合計をまとめてください。」
   • 「取引による利益を表示してください。」

4. 残高の取得：

   • 「アカウントの残高はいくらですか？」
   • 「取引アカウントにはいくらありますか？」
   • 「Freqtrade ウォレットの現在の残高を教えてください。」

5. パフォーマンスの取得：

   • 「ボットのパフォーマンスはどの程度ですか？」
   • 「取引のパフォーマンス指標を教えてください。」
   • 「取引統計を表示してください。」

6. ホワイトリストの取得：

   • 「ホワイトリストに登録されている通貨ペアはどれですか？」
   • 「ボットで使用できる通貨ペアはどれですか？」
   • 「ホワイトリストに登録されている通貨ペアを一覧表示してください。」

7. ブラックリストの取得：

   • 「ブラックリストに登録されている通貨ペアはどれですか？」
   • 「現在、取引が禁止されている通貨ペアはどれですか？」
   • 「ブラックリストについて教えてください。」

8. 取引の取得：

   • 「クローズ済み取引の履歴を教えてください。」
   • 「ボットが完了したすべての取引を表示してください。」
   • 「過去の取引を一覧表示してください。」

9. 設定の取得：

   • 「現在のボット設定を教えてください。」
   • 「ボットが使用している設定を表示してください。」
   • 「Freqtrade の設定について教えてください。」

10. ロックの取得：

    • 「アクティブな取引ロックはありますか？」
    • 「現在設定されているロックは何ですか？」
    • 「取引ロックの一覧を表示してください。」

11. 取引の発注：

    • 「今すぐ BTC/USDT を 0.01 買ってください。」
    • 「すぐに ETH/USDT を 0.05 売ってください。」
    • 「XRP/USDT を 0.1 買う注文を出してください。」

12. ボットの起動：

    • 「取引ボットを起動してください。」
    • 「Freqtrade ボットをオンにしてください。」
    • 「今すぐボットを稼働させてください。」

13. ボットの停止：

    • 「取引ボットを停止してください。」
    • 「Freqtrade ボットをシャットダウンしてください。」
    • 「ボットの取引を一時停止してください。」

14. 設定の再読み込み：

    • 「ボットの設定を再読み込みしてください。」
    • 「ボットの設定を更新してください。」
    • 「Freqtrade の設定を更新してください。」

15. ブラックリストへの追加：

    • 「ETH/USDT をブラックリストに登録してください。」
    • 「BTC/ETH をブラックリストに追加してください。」
    • 「XRP/USDT の取引を禁止してください。」

16. ブラックリストからの削除：

    • 「ETH/USDT をブラックリストから削除してください。」
    • 「BTC/ETH の取引禁止を解除してください。」
    • 「XRP/USDT をブラックリストから外してください。」

17. ロックの削除：

    • 「ID 123 の取引ロックを削除してください。」
    • 「番号 45 のロックを解除してください。」
    • 「ID 7 の取引ロックを解除してください。」

ライセンス

このプロジェクトは MIT ライセンスの下でライセンスされています。詳細については、LICENSE ファイルをご覧ください。