Freqtrade-MCP
Overview
基本能力
产品定位
Freqtrade-MCP 是一个与 Freqtrade 加密货币交易机器人集成的 MCP 服务器，通过其 REST API 实现无缝的 AI 代理交互，用于自动化交易操作。
核心功能
- 提供与 Freqtrade 的 REST API 集成的能力。
- 支持多种交易操作，如获取市场数据、交易状态、利润摘要、账户余额等。
- 支持交易操作，如买卖交易、启动/停止机器人、重新加载配置等。
适用场景
- 自动化加密货币交易。
- 实时监控交易状态和市场数据。
- 通过 AI 代理进行交易决策。
工具列表
| 工具名称 | 描述 | 参数 |
|---|---|---|
fetch_market_data |
获取交易对的 OHLCV 数据 | pair: str, timeframe: str |
fetch_bot_status |
获取开放交易状态 | 无 |
fetch_profit |
获取利润摘要 | 无 |
fetch_balance |
获取账户余额 | 无 |
fetch_performance |
获取性能指标 | 无 |
fetch_whitelist |
获取白名单交易对 | 无 |
fetch_blacklist |
获取黑名单交易对 | 无 |
fetch_trades |
获取交易历史 | 无 |
fetch_config |
获取机器人配置 | 无 |
fetch_locks |
获取交易锁 | 无 |
place_trade |
执行买卖交易 | pair: str, side: str, stake_amount: float |
start_bot |
启动机器人 | 无 |
stop_bot |
停止机器人 | 无 |
reload_config |
重新加载配置 | 无 |
add_blacklist |
添加交易对到黑名单 | pair: str |
delete_blacklist |
从黑名单中移除交易对 | pair: str |
delete_lock |
删除交易锁 | lock_id: int |
常见问题解答
- 如何启用 Freqtrade 的 REST API？
在 Freqtrade 配置文件中添加
api_server部分并设置enabled为true。 - 如何配置 Freqtrade-MCP？
在
mcpServers配置中指定 Freqtrade-MCP 的命令、参数和环境变量。
使用教程
使用依赖
- Python 3.13+：确保系统已安装 Python 3.13 或更高版本。
- Freqtrade：运行中的 Freqtrade 实例，并启用 REST API。
- Git：用于克隆仓库。
安装教程
-
克隆仓库：
bash git clone https://github.com/kukapay/freqtrade-mcp.git cd freqtrade-mcp -
安装依赖： 使用
pip：bash pip install freqtrade-client mcp[cli]或使用uv（可选）：bash uv add freqtrade-client "mcp[cli]" -
客户端配置：
json "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 配置： 在 Freqtrade 配置文件中添加以下内容以启用 REST API：
json "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-MCP 后，可以通过调用工具列表中的 API 进行调试。
- 检查日志以确保 Freqtrade-MCP 和 Freqtrade 之间的连接正常。