Freqtrade MCP 서버

“Freqtrade” MCP 서버는 무엇을 하나요?

Freqtrade MCP 서버는 Freqtrade 암호화폐 트레이딩 봇과 REST API를 통해 완벽하게 통합되는 Model Context Protocol(MCP) 서버입니다. 이 서버는 AI 어시스턴트와 Freqtrade 플랫폼 간의 브릿지 역할을 하여, AI 에이전트가 자동 매매, 실시간 시장 데이터 접근, 트레이딩 전략 관리, 트레이딩 계좌와의 프로그래밍적 상호작용을 할 수 있도록 해줍니다. 이 통합은 트레이딩 워크플로우의 개발과 자동화를 한층 높여주며, 매매 실행, 잔고 조회, 성과 모니터링 등 다양한 작업을 AI 기반 워크플로우로 완전히 자동화할 수 있습니다. Freqtrade MCP 서버는 AI를 통한 고급 트레이딩 자동화 및 의사결정을 원하는 개발자와 트레이더에게 이상적입니다.

프롬프트 목록

저장소에는 명시적인 프롬프트 템플릿이 없습니다.

리소스 목록

저장소에 별도의 리소스는 언급되어 있지 않습니다.

도구 목록

명시적인 도구 목록이나 server.py 파일이 없으며, 도구 정의도 문서화되어 있지 않습니다.

이 MCP 서버의 활용 사례

• 자동 매매 실행
  AI 에이전트가 Freqtrade 봇에서 매수/매도 주문을 실행할 수 있어 트레이딩 전략을 자동화하고 수동 개입을 줄입니다.
• 포트폴리오 모니터링
  개발자가 포트폴리오 수익률, 잔고, 오픈 포지션을 프로그래밍적으로 모니터링할 수 있어 실시간 의사결정에 도움을 줍니다.
• 전략 관리
  AI 워크플로우를 통해 트레이딩 전략의 관리 및 전환을 지원하여, 백테스팅과 배포 과정을 간소화합니다.
• 시장 데이터 조회
  Freqtrade REST API를 통해 AI가 최신 시장 데이터와 시세 정보를 받아 데이터 기반 트레이딩 알고리즘을 구현할 수 있습니다.

설치 방법

Windsurf

1. 사전 준비:
   Python 3.13+, Freqtrade(REST API 활성화), Git이 설치되어 있는지 확인합니다.
2. 저장소 클론:

   git clone https://github.com/kukapay/freqtrade-mcp.git
   cd freqtrade-mcp
   

3. 의존성 설치:

   pip install freqtrade-client mcp[cli]
   

4. Windsurf 설정 수정:
   설정 파일에 아래 내용을 추가합니다:

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

5. 저장 및 재시작:
   설정을 저장하고 Windsurf를 재시작합니다. MCP 서버가 정상적으로 작동하는지 확인하세요.

Claude

1. 사전 준비:
   Python 3.13+, Freqtrade, Git을 설치합니다.
2. 클론 및 설치:

   git clone https://github.com/kukapay/freqtrade-mcp.git
   cd freqtrade-mcp
   pip install freqtrade-client mcp[cli]
   

3. Claude 설정 수정:
   위와 같이 MCP 서버 설정을 적절한 JSON 위치에 추가합니다.
4. 저장 및 재시작:
   변경사항을 저장한 뒤 Claude를 재시작해 MCP 서버를 활성화합니다.

Cursor

1. 사전 준비:
   Python 3.13+, Freqtrade, Git이 설치되어 있어야 합니다.
2. 클론 및 설치:

   git clone https://github.com/kukapay/freqtrade-mcp.git
   cd freqtrade-mcp
   pip install freqtrade-client mcp[cli]
   

3. Cursor 설정 수정:
   mcpServers 섹션에 아래 내용을 추가합니다:

   "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. 저장 및 재시작:
   Cursor를 재시작하고 서버가 정상 작동하는지 확인하세요.

Cline

1. 사전 준비:
   Python 3.13+, Freqtrade, Git이 필요합니다.
2. 클론 및 설치:

   git clone https://github.com/kukapay/freqtrade-mcp.git
   cd freqtrade-mcp
   pip install freqtrade-client mcp[cli]
   

3. Cline 설정:
   mcpServers 섹션에 아래 내용을 추가하세요:

   "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. 저장 및 재시작:
   설정을 저장하고 Cline을 재시작하세요. MCP 통합이 정상인지 확인합니다.

API 키 보안:
API 자격증명은 환경 변수로 설정에 저장하세요:

"env": {
  "FREQTRADE_API_URL": "http://127.0.0.1:8080",
  "FREQTRADE_USERNAME": "${FREQTRADE_USERNAME}",
  "FREQTRADE_PASSWORD": "${FREQTRADE_PASSWORD}"
},
"inputs": {
  "FREQTRADE_USERNAME": "your_username",
  "FREQTRADE_PASSWORD": "your_password"
}

플로우 내에서 MCP 활용 방법

FlowHunt에서 MCP 사용하기

FlowHunt 워크플로우에 MCP 서버를 통합하려면, MCP 컴포넌트를 플로우에 추가하고 AI 에이전트와 연결하세요.

MCP 컴포넌트를 클릭하여 설정 패널을 엽니다. 시스템 MCP 설정 섹션에 아래와 같은 JSON 포맷으로 MCP 서버 정보를 입력하세요:

{
  "freqtrade-mcp": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

구성이 완료되면, AI 에이전트가 이 MCP를 도구로 활용하여 모든 기능을 사용할 수 있습니다. “freqtrade-mcp"는 실제 MCP 서버 이름으로, URL은 사용자의 MCP 서버 주소로 변경해 주세요.

개요

위 표를 보면 Freqtrade MCP 서버는 전반적인 개요와 설치 가이드는 명확하게 제공하지만, 프롬프트, 리소스, 도구에 대한 공개 문서는 부족합니다. Freqtrade와 AI 통합에는 강점이 있으나 문서화의 깊이가 낮아 완성도가 떨어집니다.

MCP 점수

오피니언:
Freqtrade MCP 서버는 자동화 트레이딩 워크플로우 및 AI 통합에 유용하지만, 사용 가능한 도구, 프롬프트 템플릿, 리소스에 대한 문서가 더 보강되면 좋겠습니다. 설치 가이드는 명확하고 오픈소스이지만, 고급 사용자를 위한 MCP 기능 커버리지는 미흡합니다.

평가: 4/10