freqtrade-mcp: Claude에게 당신의 거래를 확인해 달라고 요청하기

Source: Dev.to

개요

저는 Freqtrade 봇을 운영하고 있으며, 많은 봇 사용자들처럼 UI를 계속 확인하게 됩니다.
FreqUI 웹 인터페이스로 전환하는 대신, 저는 Claude를 사용해 REST API를 통해 봇에 질의합니다.

저는 15개의 도구를 제공하는 TypeScript MCP 서버인 @furkankoykiran/freqtrade-mcp를 만들었습니다.
Claude(Desktop, Cursor, Cline 또는 Model Context Protocol을 지원하는 모든 클라이언트)는 봇에게 자연스러운 영어로 질문하고 구조화된 JSON 응답을 받을 수 있으며, Claude는 이를 읽기 쉬운 요약으로 포맷합니다.

예시 질의

수익 및 잔액

• “전체적으로 내가 만든 수익은 얼마인가요? 솔직히 말해 주세요.”
• “현재 잔액은 얼마인가요 — 배치된 금액과 USDT로 그대로 있는 금액은 각각 얼마인가요?”
• “어떤 페어가 잘 움직이고 있나요? 상위 5개를 보여 주세요, 내 결정에 대해 좀 더 안심하고 싶어요.”
• “이번 달에 순이익이 나는 중인가요, 아니면 손해 보고 있나요?”

사용 도구: get_profit_stats, get_balance, get_performance

거래

• “현재 열려 있는 거래는 무엇인가요? 적자 상태인 것이 있나요?”
• “거래 #42를 보여 주세요 — 언제 열렸고, 손익은 얼마이며, 걱정할 필요가 있나요?”
• “마감된 최근 10개의 거래를 알려 주세요.”

사용 도구: get_open_trades, get_trade, get_trade_history

시장 데이터

• “4 시간 차트에서 최근 50개의 BTC/USDT 캔들을 가져와 주세요.”
• “현재 ETH/USDT 1 시간 차트는 어떻게 보이나요?”

사용 도구: get_market_data

페어 목록

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

사용 도구: add_to_blacklist, remove_from_blacklist, get_whitelist, get_blacklist

실행

• “지금 바로 ETH 100 USDT를 매수해 주세요.”
• “BTC/USDT에 50 USDT 규모의 숏 포지션을 열어 주세요.”
• “거래 #7을 시장가로 청산해 주세요.”

사용 도구: execute_trade, force_exit_trade

주의: 이 명령들은 실시간 거래소에 즉시 실행됩니다. 의도적으로 사용하시고, 확인 대화창이나 실행 취소 기능은 없습니다.

봇 라이프사이클

• “봇을 중지해 주세요 — 설정을 수정해야 합니다.”
• “봇을 재시작하지 않고 설정을 다시 로드해 주세요; 현재 사이클 진행 중입니다.”
• “봇의 현재 버전은 무엇인가요? 최근에 실행됐나요, 아니면 조용히 실패하고 있나요?”

사용 도구: stop_bot, start_bot, reload_config, get_bot_info, get_locks, delete_lock

도구 개요

설정

1. REST API를 활성화 하세요 config.json에서 (기본적으로 비활성화되어 있습니다).

2. 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"
         }
       }
     }
   }

3. Claude Desktop을 재시작하세요. 모든 15개의 도구가 즉시 표시됩니다—추가 빌드 단계가 필요하지 않습니다.

---

라이선스 및 출처

이 프로젝트는 오픈 소스이며 MIT 라이선스로 제공됩니다.
전체 설정 방법은 저장소의 README에 있습니다.

github.com/furkankoykiran/freqtrade-mcp