加密货币交易代理服务器

Freqtrade-MCP是一个与Freqtrade加密货币交易机器人集成的服务器,通过REST API实现AI代理交互,支持自动化交易操作。

  • by kukapay
  • Python
  • 本地部署
  • 148 星标
  • 更新于
在 GitHub 查看 kukapay/freqtrade-mcp

使用说明

Freqtrade MCP

与集成的MCP服务器 Freqtrade 加密货币交易机器人通过其REST API,实现自动化交易操作的无缝人工智能代理交互。

有关更多与加密相关的MCP服务器,请参阅 Kukapay MCP服务器.

安装

先决条件

  • Python 3.13+:确保您的系统上安装了Python。
  • Freqtrade:启用REST API的Freqtrade实例(请参阅 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. 频率配置:

    通过将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

示例提示

  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. 启动Bot:

    • “启动交易机器人。”
    • “打开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许可证获得许可。请参阅 许可证 文件以获取详细信息。