freqtrade-mcp 是一个 MCP 服务器，用于通过 Freqtrade 加密货币交易机器人的 REST API 与其集成，实现 AI 代理与 Freqtrade 的无缝交互，以便进行自动化交易操作。
用途：将 Freqtrade 的 REST API 端点封装为 MCP 工具，供 AI 代理调用，从而查询交易数据或执行交易操作。
主要能力：服务器暴露以下 Freqtrade API 端点作为 MCP 工具，包括获取市场数据、获取机器人状态、获取利润、获取余额、获取表现、获取白名单、获取黑名单、获取交易记录、获取配置、获取锁、下单交易、启动机器人、停止机器人、重载配置、添加黑名单、删除黑名单、删除锁。用户可以用自然语言提示词触发这些操作，例如“显示 BTC/USDT 的小时价格数据”“我的未平仓交易当前状态如何”“我目前赚了多少利润”“我的账户余额是多少”“机器人表现如何”“哪些交易对在白名单中”“哪些交易对被列入黑名单”“我的已平仓交易历史是什么”“当前机器人配置是什么”“是否有交易锁处于活动状态”“立即买入 0.01 BTC/USDT”“启动交易机器人”“停止交易机器人”“重载机器人配置”“将 ETH/USDT 加入黑名单”“从黑名单移除 ETH/USDT”“删除 ID 为 123 的交易锁”等。
使用方式：需要 Python 3.13+、一个已启用 REST API 的 Freqtrade 实例以及 Git。先克隆仓库：git clone https://github.com/kukapay/freqtrade-mcp.git，然后 cd freqtrade-mcp。安装依赖：使用 pip 安装 pip install freqtrade-client mcp[cli]，或使用 uv（可选）uv add freqtrade-client "mcp[cli]"。接着配置 MCP 客户端，示例配置为："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" } } }。同时需要在 Freqtrade 配置中启用 REST API：添加 api_server 部分并将 api_server.enabled 设为 true。示例配置："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" }。更多信息可查看相关文档。
适用场景：适用于需要让 AI 代理通过自然语言与 Freqtrade 交易机器人交互的自动化交易操作场景，例如查询市场行情、监控机器人状态与表现、查看账户余额与交易历史、管理白名单/黑名单与交易锁，以及执行下单、启动/停止机器人、重载配置等操作。
限制：需要 Python 3.13+、已启用 REST API 的 Freqtrade 实例和 Git。Freqtrade 配置需要启用 api_server 并设置 enabled 为 true。项目采用 MIT 许可证，详见 LICENSE 文件。其他未在资料中说明的限制暂未提供。
