Freqtrade-MCP

MCP 服务器通过其 REST API 与Freqtrade加密货币交易机器人集成，实现自动交易操作的无缝 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 来启用其余 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 的每小时价格数据。”

   • “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 许可证。详情请参阅许可证文件。