フリークトレード-MCP
REST API を介してFreqtrade暗号通貨取引ボットと統合し、自動取引操作のためのシームレスな AI エージェントの相互作用を可能にする MCP サーバー。
インストール
前提条件
Python 3.13+ : システムに Python がインストールされていることを確認してください。
Freqtrade : REST API が有効になっている実行中の Freqtrade インスタンス ( Freqtrade Docsを参照)。
Git : リポジトリのクローンを作成します。
手順
リポジトリのクローンを作成します:
git clone https://github.com/kukapay/freqtrade-mcp.git cd freqtrade-mcp依存関係のインストール:
pipの使用:pip install freqtrade-client mcp[cli]または
uv付き（オプション）:uv add freqtrade-client "mcp[cli]"クライアント構成:
"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" } } }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" },こちらでドキュメントを確認してください。
Related MCP server: Armor Crypto MCP
使用法
利用可能なツール
サーバーは、次の Freqtrade API エンドポイントを MCP ツールとして公開します。
道具 | 説明 | パラメータ |
| ペアのOHLCVデータを取得する |
、
|
| オープントレードステータスを取得する | なし |
| 利益概要を取得する | なし |
| アカウント残高を取得する | なし |
| パフォーマンスメトリックを取得する | なし |
| ペアのホワイトリストを取得する | なし |
| ペアのブラックリストを取得する | なし |
| 取引履歴を取得する | なし |
| ボットの設定を取得する | なし |
| トレードロックを取得する | なし |
| 売買取引を行う |
、
、
|
| ボットを起動する | なし |
| ボットを停止 | なし |
| ボット設定を再読み込み | なし |
| ペアをブラックリストに追加 |
|
| ブラックリストからペアを削除する |
|
| トレードロックを削除する |
|
プロンプトの例
市場データを取得:
「BTC/USDT の 1 時間ごとの価格データを表示してください。」
「ETH/BTCの5分チャートはどうなっているでしょうか？」
「過去 1 時間の XRP/USDT の最新のローソク足データを教えてください。」
フェッチボットステータス:
「私のオープン取引の現在のステータスはどうなっていますか？」
「現在、アクティブな取引はありますか？」
「現時点でのボットの取引活動について教えてください。」
フェッチ利益:
「これまでにどれくらいの利益が出ましたか？」
「ボットの総利益の概要はいくらですか？」
「私の取引利益を見せてもらえますか？」
フェッチ残高:
「口座残高はいくらですか？」
「取引口座にはいくらお金がありますか？」
「Freqtrade ウォレットの現在の残高を教えてください。」
フェッチパフォーマンス:
「ボットのパフォーマンスはどの程度ですか？」
「私の取引のパフォーマンス指標は何ですか？」
「取引統計を見せてください。」
ホワイトリストを取得:
「ホワイトリストに載っているペアはどれですか？」
「ボットはどのような取引ペアを使用できますか？」
「ホワイトリストに登録されたペアを一覧表示してください。」
ブラックリストを取得:
「どのペアがブラックリストに載っていますか？」
「現在ブロックされている取引ペアは何ですか？」
「ブラックリストについて教えてください。」
フェッチトレード:
「終了した取引の履歴は何ですか？」
「ボットが完了した取引をすべて表示してください。」
「過去の取引履歴をリストにしていただけますか？」
設定の取得:
「現在のボットの構成は何ですか？」
「ボットが使用している設定を見せてください。」
「Freqtrade の設定について教えてください。」
フェッチロック:
「アクティブな貿易ロックはありますか？」
「現在どのようなロックがかかっていますか？」
「取引ロックのリストを見せてください。」
場所トレード：
「今すぐ0.01 BTC/USDTを購入してください。」
「0.05 ETH/USDTをすぐに売却します。」
「0.1 XRP/USDT の買い注文を出してください。」
ボットを起動:
「トレーディングボットを起動します。」
「Freqtrade ボットをオンにしてください。」
「今すぐボットを実行してください。」
ボットを停止:
「トレーディングボットを停止します。」
「Freqtrade ボットをシャットダウンしてください。」
「ボットの取引を一時停止します。」
設定を再読み込み:
「ボットの設定をリロードします。」
「ボットの設定を更新してください。」
「Freqtrade の設定を更新します。」
ブラックリストを追加:
「ETH/USDTをブラックリストに追加します。」
「BTC/ETHをブラックリストに追加します。」
「XRP/USDTのブロック取引」
ブラックリストを削除:
「ETH/USDTをブラックリストから削除します。」
「取引のためにBTC/ETHのブロックを解除します。」
「XRP/USDTをブラックリストから外してください。」
削除ロック:
「ID 123 のトレードロックを削除します。」
「ロック番号45を外してください。」
「ID 7でトレードのロックを解除します。」
ライセンス
このプロジェクトはMITライセンスの下で提供されています。詳細はLICENSEファイルをご覧ください。