FreqUI 접속 없이 Claude로 제어하는 Freqtrade MCP 서버 구축

Context

FreqUI 접속 및 메뉴 탐색을 통한 봇 상태 확인 과정의 번거로움 발생. 단순 수치 확인을 위해 반복적인 웹 인터페이스 조작 필요. REST API가 존재함에도 불구하고 효율적인 인터페이스 부재로 인한 운영 효율 저하.

Technical Solution

• Model Context Protocol(MCP) 표준을 채택하여 Claude Desktop 및 Cursor와 Freqtrade 간의 직접적인 통신 구조 설계
• TypeScript 기반의 MCP 서버를 구축하여 Freqtrade REST API를 15개의 세부 도구(Tools)로 추상화
• JSON 형태의 로우 데이터를 Claude가 해석 가능한 자연어 형태로 변환하는 인터페이스 계층 구현
• OHLCV 데이터 추출을 위한 get_market_data 도구를 통해 외부 거래소 실시간 데이터의 LLM 분석 흐름 구축
• execute_trade 및 force_exit_trade 함수를 매핑하여 자연어 명령을 통한 즉각적인 거래 실행 로직 구현
• config.json의 REST API 활성화와 npx 기반의 제로 빌드 설치 프로세스 적용

Key Takeaway

기존 REST API라는 기능적 자산을 MCP 표준으로 래핑함으로써 복잡한 GUI 조작 없이 자연어로 시스템 상태를 관찰하고 제어하는 인터페이스 전환 전략.