使用说明
Freqtrade MCP
与集成的MCP服务器 Freqtrade 加密货币交易机器人通过其REST API,实现自动化交易操作的无缝人工智能代理交互。
有关更多与加密相关的MCP服务器,请参阅 Kukapay MCP服务器.
安装
先决条件
- Python 3.13+:确保您的系统上安装了Python。
- Freqtrade:启用REST API的Freqtrade实例(请参阅 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]" -
客户端配置:
"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" } } } -
频率配置:
通过将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工具:
| 工具 | 说明 | 参数 |
|---|---|---|
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 |
示例提示
-
获取市场数据:
- “显示BTC/USDT的每小时价格数据。”
- “ETH/BTC的5分钟图表是什么样的?”
- “给我过去一小时XRP/USDT的最新烛台数据。”
-
获取机器人状态:
- “我的未平仓交易的当前状态如何?”
- “现在有任何活跃的交易吗?”
- “告诉我机器人目前的交易活动。”
-
获取利润:
- “到目前为止,我赚了多少钱?”
- “机器人的总利润是多少?”
- “你能给我看看我的交易收益吗?”
-
提取余额:
- “我的账户余额是多少?”
- “我的交易账户里有多少钱?”
- “告诉我我Freqtrade钱包的当前余额。”
-
获取性能:
- “机器人的表现如何?”
- “我的交易的绩效指标是什么?”
- “给我看看交易统计数据。”
-
获取白名单:
- “白名单上有哪对?”
- “机器人可以使用哪些交易对?”
- “为我列出白名单上的配对。”
-
获取黑名单:
- “哪些鞋被列入黑名单?”
- “现在哪些交易对被封锁了?”
- “跟我说说黑名单。”
-
获取交易:
- “我关闭的交易的历史是什么?”
- “给我看看机器人完成的所有交易。”
- “你能列出我过去的交易吗?”
-
获取配置:
- “当前的机器人配置是什么?”
- “显示机器人正在使用的设置。”
- “告诉我Freqtrade配置。”
-
取锁:
- “是否有任何贸易锁处于活动状态?”
- “目前有什么锁?”
- “给我看看交易锁列表。”
-
地点交易:
- “立即购买0.01 BTC/USDT。”
- “立即卖出0.05 ETH/USDT。”
- “下单购买0.1 XRP/USDT。”
-
启动Bot:
- “启动交易机器人。”
- “打开Freqtrade机器人。”
- “现在让机器人运行。”
-
停止机器人:
- “停止交易机器人。”
- “关闭Freqtrade机器人。”
- “暂停机器人的交易。”
-
重新加载配置:
- “重新加载机器人的配置。”
- “更新机器人设置。”
- “刷新Freqtrade配置。”
-
添加黑名单:
- “黑名单ETH/USDT。”
- “将BTC/ETH添加到黑名单中。”
- “XRP/USDT的大宗交易。”
-
删除黑名单:
- “从黑名单中删除ETH/USDT。”
- “解锁BTC/ETH进行交易。”
- “将XRP/USDT从黑名单中删除。”
-
删除锁:
- “删除ID为123的交易锁。”
- “拆下45号锁。”
- “使用ID 7解锁交易。”
许可证
该项目根据MIT许可证获得许可。请参阅 许可证 文件以获取详细信息。