freqtrade-mcp

フリークトレード-MCP

REST API を介してFreqtrade暗号通貨取引ボットと統合し、自動取引操作のためのシームレスな AI エージェントの相互作用を可能にする MCP サーバー。

インストール

前提条件

• Python 3.13+ : システムに Python がインストールされていることを確認してください。
• Freqtrade : REST API が有効になっている実行中の Freqtrade インスタンス ( Freqtrade Docsを参照)。
• 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 ツールとして公開します。

プロンプトの例

1. 市場データを取得:
   • 「BTC/USDT の 1 時間ごとの価格データを表示してください。」
   • 「ETH/BTCの5分チャートはどうなっているでしょうか？」
   • 「過去 1 時間の XRP/USDT の最新のローソク足データを教えてください。」
2. フェッチボットステータス:
   • 「私のオープン取引の現在のステータスはどうなっていますか？」
   • 「現在、アクティブな取引はありますか？」
   • 「現時点でのボットの取引活動について教えてください。」
3. フェッチ利益:
   • 「これまでにどれくらいの利益が出ましたか？」
   • 「ボットの総利益の概要はいくらですか？」
   • 「私の取引利益を見せてもらえますか？」
4. フェッチ残高:
   • 「口座残高はいくらですか？」
   • 「取引口座にはいくらお金がありますか？」
   • 「Freqtrade ウォレットの現在の残高を教えてください。」
5. フェッチパフォーマンス:
   • 「ボットのパフォーマンスはどの程度ですか？」
   • 「私の取引のパフォーマンス指標は何ですか？」
   • 「取引統計を見せてください。」
6. ホワイトリストを取得:
   • 「ホワイトリストに載っているペアはどれですか？」
   • 「ボットはどのような取引ペアを使用できますか？」
   • 「ホワイトリストに登録されたペアを一覧表示してください。」
7. ブラックリストを取得:
   • 「どのペアがブラックリストに載っていますか？」
   • 「現在ブロックされている取引ペアは何ですか？」
   • 「ブラックリストについて教えてください。」
8. フェッチトレード:
   • 「終了した取引の履歴は何ですか？」
   • 「ボットが完了した取引をすべて表示してください。」
   • 「過去の取引履歴をリストにしていただけますか？」
9. 設定の取得:
   • 「現在のボットの構成は何ですか？」
   • 「ボットが使用している設定を見せてください。」
   • 「Freqtrade の設定について教えてください。」
10. フェッチロック:

• 「アクティブな貿易ロックはありますか？」
• 「現在どのようなロックがかかっていますか？」
• 「取引ロックのリストを見せてください。」

11. 場所トレード：

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

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ファイルをご覧ください。