freqtrade-mcp

Freqtrade-MCP

REST API를 통해 Freqtrade 암호화폐 거래 봇과 통합되는 MCP 서버로, 자동화된 거래 작업을 위한 원활한 AI 에이전트 상호 작용이 가능합니다.

설치

필수 조건

• Python 3.13+ : 시스템에 Python이 설치되어 있는지 확인하세요.
• Freqtrade : REST API가 활성화된 실행 중인 Freqtrade 인스턴스입니다( Freqtrade 문서 참조).
• Git : 저장소를 복제합니다.

단계

1. 저장소 복제 :지엑스피1
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. Freqtrade 구성 :구성에 api_server 섹션을 추가하고 api_server.enabled를 true로 설정하여 REST 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 도구로 노출합니다.

예시 프롬프트

1. 시장 데이터 가져오기 :
   • "BTC/USDT의 시간당 가격 데이터를 보여주세요."
   • "ETH/BTC의 5분 차트는 어떤가요?"
   • "지난 1시간 동안의 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. 봇 시작 :

• "거래 봇을 시작하세요."
• "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 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 라이선스 파일을 참조하세요.