Freqtrade-MCP

一个与Freqtrade加密货币交易机器人通过其REST API集成的MCP服务器，使AI代理能够无缝交互以实现自动化交易操作。

安装

预备条件

• Python 3.13+: 确保系统中已安装Python。
• Freqtrade: 运行中的Freqtrade实例，并启用了REST API（参见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": 2020,
       "verbosity": "error",
       "enable_openapi": false,
       "jwt_secret_key": "somethingrandom",
       "CORS_origins": [],
       "username": "Freqtrader",
       "password": "SuperSecret1!",
       "ws_token": "sercet_Ws_t0ken"
   },
   

   查看文档这里。

使用

可用工具

该服务器暴露了以下作为MCP工具的Freqtrade API端点：

工具	描述	参数
fetch_market_data	获取一对的OHLCV数据	pair: str, timeframe: str
fetch_bot_status	获取开放交易状态	None
fetch_profit	获取利润摘要	None
fetch_balance	获取账户余额	None
fetch_performance	获取性能指标	None
fetch_whitelist	获取配对白名单	None
fetch_blacklist	获取配对黑名单	None
fetch_trades	获取交易历史	None
fetch_config	获取机器人配置	None
fetch_locks	获取交易锁定	None
place_trade	下单买入/卖出交易	pair: str, side: str, stake_amount: float
start_bot	启动机器人	None
stop_bot	停止机器人	None
reload_config	重新加载机器人配置	None
add_blacklist	将配对添加到黑名单	pair: str
delete_blacklist	从黑名单中移除配对	pair: str
delete_lock	删除交易锁定	lock_id: int

示例提示

1. 获取市场数据:

   • "给我BTC/USDT的每小时价格数据。"
   • "ETH/BTC的5分钟图表是什么样的？"
   • "给我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文件。 </中文翻译>