freqtrade-mcp

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