freqtrade-mcp: 봇을 통해 Claude에게 물어보세요

Source: Dev.to

(번역할 텍스트를 제공해 주시면 한국어로 번역해 드리겠습니다.)

소개

Freqtrade 봇을 실행하고 있습니다. 전략은 존재하고, 봇은 일을 수행하며, 이론적으로는 제가 개입할 필요가 없습니다… 실제로는 밤 11시에 화면을 보면서 “혹시”라는 질문을 넘기지 못합니다. FreqUI를 열어 탭을 클릭하는 대신, @furkankoykiran/freqtrade-mcp 라는 TypeScript MCP 서버를 작성해 Claude에 REST API를 열었습니다. Claude Desktop, Cursor, Cline 및 Model Context Protocol (MCP)과 함께 작동하는 이 도구는 Freqtrade 데이터를 자연어로 질문하고 즉시 답변을 받을 수 있게 해줍니다.

Freqtrade — 이제 열지 않아도 정보를 얻을 수 있습니다.

Source: …

무엇이 작동하나요

포트폴리오 현황

밤 23시에 자주 묻는 질문:

• “이번 달 순이익이 플러스인가요, 아니면 보지 말아야 하나요?”
• “현재 USDT가 얼마나 오픈 포지션에 잡혀 있고, 얼마나 유동성으로 남아 있나요?”
• “어떤 거래쌍이 잘 움직이고 있나요?”

get_profit_stats, get_balance, get_performance 메서드가 이 질문들을 처리합니다. Claude가 JSON을 읽기 쉬운 형태로 변환해 주므로, 직접 숫자를 해석할 필요가 없습니다.

포지션

• “오픈된 거래는 어떤 상태인가요, 손실이 나는 것이 있나요?”
• “42번 거래 – 개시 날짜는 언제이며 현재 손익 비율은 얼마인가요?”
• “최근 10개의 종료된 거래를 보여 주세요.”

봇은 동시에 수십 개의 포지션을 보유할 수 있습니다; 각 줄을 일일이 읽는 대신 Claude에게 물어 즉시 결과를 얻을 수 있습니다.

시장 데이터

• “BTC/USDT 4시간 차트, 최근 50개의 캔들.”
• “ETH/USDT 현재 1시간 차트는 어떻게 보이나요?”

get_market_data는 거래소에서 실시간 OHLCV 데이터를 가져옵니다. Claude가 차트를 보고 해석할 수 있으며, 실제 행동은 여러분에게 달려 있습니다.

Freqtrade의 분석 화면 — MCP 서버도 동일한 데이터를 실시간으로 가져옵니다.

리스트 관리

• “LUNA/USDT를 블랙리스트에 추가해 주세요.”
• “화이트리스트에 무엇이 있나요? BNB/BTC를 블랙리스트에서 제거해 주세요.”

보통은 설정 파일을 직접 수정하거나 FreqUI 메뉴를 탐색합니다; 이제는 한 문장으로 처리할 수 있습니다.

수동 거래

• “지금 100 USDT로 ETH를 매수해 주세요.”
• “BTC/USDT에서 50 USDT로 숏 포지션을 열어 주세요.”
• “번호 7인 거래를 종료해 주세요.”

execute_trade와 force_exit_trade 명령은 전략이 기다리지 않고 즉시 실행됩니다.

중요: 실제 거래소, 실제 자금; 되돌릴 수 없습니다. 확인 화면이 없으니 주의하시기 바랍니다.

봇 관리

• “봇을 중지해 주세요, 설정을 바꾸고 싶어요.”
• “재시작 없이 설정을 업데이트해 주세요.”
• “봇이 마지막으로 언제 실행됐으며, 아직 작동 중인가요?”

get_bot_info는 버전과 상태 정보를 한 번에 제공하므로 FreqUI를 열 필요가 없습니다.

설치

Freqtrade의 config.json 파일에서 REST API를 활성화하세요 (기본적으로 비활성화되어 있습니다). 그런 다음 Claude Desktop 설정에 아래 MCP 서버를 추가합니다:

{
  "mcpServers": {
    "freqtrade": {
      "command": "npx",
      "args": ["-y", "@furkankoykiran/freqtrade-mcp"],
      "env": {
        "FREQTRADE_API_URL": "http://127.0.0.1:8080",
        "FREQTRADE_USERNAME": "Freqtrader",
        "FREQTRADE_PASSWORD": "YourPassword"
      }
    }
  }
}

Claude Desktop을 재시작하세요. 이제 15개의 도구가 준비되었습니다; 추가 빌드 단계가 필요 없습니다.

도구

결론

내 목표는 FreqUI를 열지 않고도 봇을 볼 수 있게 하는 것이었습니다. REST API는 이미 있었고, 단지 인터페이스 뒤에 내장되어 있었습니다. 이제 Claude에게 물어보고, 답을 받아서 진행합니다. “변경됐을까?” 하는 느낌은 여전히 있지만, 질문을 하는 것이 훨씬 쉬워졌습니다.

프로젝트는 오픈 소스이며 MIT 라이선스를 사용합니다. 설치 및 사용 상세 정보는 README에서 확인할 수 있습니다.

github.com/furkankoykiran/freqtrade-mcp

이 글은 DevTo-MCP 를 통해 DEV.to에 제출되었습니다.