Freqtrade MCP

🚀 FREQTRADE - MCP プロジェクト

FREQTRADE - MCPは、Freqtradeと統合されたMCPサーバーです。REST APIを通じてAIエージェントとのインタラクションを実現します。

🚀 クイックスタート

FREQTRADE - MCPを使用するには、まずインストールと設定が必要です。以下の手順に従って操作してください。

✨ 主な機能

• REST APIを介したAIエージェントとのインタラクションを実現。
• 現在の取引ペアリストの取得。
• 履歴取引データの照会。
• 指定されたパラメータに基づく買い注文の実行。
• 現在のポートフォリオの取得と取引履歴の照会。

📦 インストール

前提条件

• Python バージョン：Python 3.8 以上。
• Freqtradeが正しくインストールされ、実行されていること。
• コードのクローンと管理にGitをインストールすること。

インストール手順

1. 以下のコマンドを使用してプロジェクトリポジトリをクローンします。

   git clone https://github.com/yourusername/freqtrade-mcp.git
   

2. プロジェクトディレクトリに移動します。

   cd freqtrade-mcp
   

3. 依存関係をインストールします。

   pip install -r requirements.txt
   

4. 環境変数を設定し、以下の内容を含めるようにします。

   {
     "FREQTRADE_API_URL": "http://localhost:8080",
     "FREQTRADE_USERNAME": "your_username",
     "FREQTRADE_PASSWORD": "your_password"
   }
   

5. サービスを起動します。

   python server.py
   

Freqtradeの設定

FreqtradeでREST APIを有効にし、以下の内容を設定します。

{
  "rest_api": {
    "enabled": true,
    "host": "localhost",
    "port": 8080,
    "username": "your_username",
    "password": "your_password"
  }
}

💻 使用例

基本的な使用法

利用可能なツール

1. 現在の取引ペアリストの取得
   • 機能：利用可能なすべての取引ペアをリストします。
   • サンプルクエリ：

     GET /api/pairs
     

2. 履歴取引データの照会
   • 機能：時間範囲と取引ペアに基づいて履歴データを取得します。
   • サンプルクエリ：

     GET /api/historical/BTCUSDT?start=2023-01-01&end=2023-12-31
     

3. 買い注文の実行
   • 機能：指定されたパラメータに基づいて買い取引を実行します。
   • サンプルクエリ：

     POST /api/trade/buy
     {
       "pair": "BTCUSDT",
       "amount": 0.5,
       "price": 40000
     }
     

高度な使用法

サンプルクエリ

• 現在のポートフォリオの取得

GET /api/portfolio

• 取引履歴の照会

GET /api/trade - history?limit=10

📄 ライセンス

このプロジェクトはMIT Licenseに準拠しています。詳細についてはLICENSEファイルを参照してください。