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": 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	获取未平仓交易状态	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 的最新 K 线图数据。"

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 文件。