Freqtrade API와 MCP 결합으로 구현한 자연어 트레이딩 제어 환경

Context

트레이딩 봇 상태 확인을 위해 FreqUI 웹 인터페이스에 반복 접속하는 컨텍스트 스위칭 비용 발생. REST API가 존재함에도 불구하고 데이터 확인을 위해 매번 브라우저와 탭을 이동해야 하는 비효율적인 구조.

Technical Solution

• Model Context Protocol(MCP) 기반의 TypeScript 서버를 구축하여 LLM과 트레이딩 봇 API 간의 표준 인터페이스 연결
• 15개의 전용 Tool을 정의하여 포트폴리오 조회, 거래 내역 분석, 시장 데이터 추출 등 복잡한 API 요청을 자연어 명령으로 추상화
• Freqtrade REST API의 구조화된 JSON 응답을 Claude가 해석하여 사용자에게 가독성 높은 요약 정보로 제공하는 데이터 파이프라인 설계
• whitelist 및 blacklist 관리 기능을 API 호출로 구현하여 JSON 설정 파일의 직접 수정 및 봇 재시작 과정 제거
• execute_trade 및 force_exit_trade 도구를 통해 전략 시그널과 무관하게 즉각적인 시장 주문을 실행하는 직접 제어 경로 확보
• npx를 통한 단일 명령 설치 구조와 환경 변수 기반의 인증 설정을 통해 배포 및 설정 복잡도 최소화

Key Takeaway

기존의 복잡한 UI 기반 관리 도구를 MCP 표준 인터페이스로 대체함으로써, 도메인 특화 API를 LLM의 도구(Tool)로 활용해 운영 효율성을 극대화하는 인터페이스 설계 방식.