프로젝트 소개

이 저장소는 Corax CoLAB이 개발한 자율 헤지 펀드 AI 오케스트레이터인 Crypto MCP 서버와 Hedgehog 에이전틱 트레이딩 대시보드를 제시합니다. 이 시스템은 Model Context Protocol(MCP) 인프라를 기반으로 구축되었으며, Claude Desktop과 같은 로컬 LLM이 실시간 시장 데이터를 수집하고 기술적 분석과 감정을 분석하며 자율적으로 거래를 실행할 수 있는 로컬화된 AI 기반 백본 역할을 하도록 설계되었습니다. 핵심 차별점은 멀티 에이전트 아키텍처 접근 방식입니다. 단순한 API 래퍼가 아닌, 이 시스템은 모든 시각화 도구에서 목업 없이 100% 실제 데이터를 사용하는 멀티 에이전트 플레이그라운드로 작동하며, 라이브 웹소켓과 REST 데이터에 의해 구동됩니다. 아키텍처는 JSON-RPC 명령을 기본적으로 다중화하며 새로운 MCP 모듈을 통한 쉬운 확장성을 지원합니다. 자율 오케스트레이터 모드는 24/7 연속 관찰-분석-행동(OODA) 루프를 구현합니다. 관찰 단계에서는 여러 MCP에 기술적 지표, 뉴스 감정, 온체인 데이터를 쿼리합니다. 분석 단계에서는 LLM(Gemini, Claude, 또는 OpenAI)을 사용하여 신호를 평가하고 구조화된 매수, 매도, 또는 보류 결정을 생성합니다. 행동 단계에서는 로컬 CCXT MCP를 통해 거래를 실행합니다. 시스템에는 실제 자금을 위험에 빠뜨리지 않고 과거 OHLCV 데이터에 대해 AI 프롬프트와 모델을 안전하게 테스트하는 에이전틱 백테스팅과 모든 행동의 추론을 상세히 설명하는 포괄적인 마크다운 보고서를 생성하는 Proof of Brain 트레이딩 일지가 포함되어 있습니다. 텔레그램 명령 센터는 실시간 알림과 원격 제어 기능을 제공하며, 활성 AI 공급자 및 최근 결정 보기, Proof of Brain 보고서 수신, 수동 OODA 주기 트리거 명령을 지원합니다. 대시보드는 React Three Fiber와 동적 발광 재질로 구동되는 여러 실시간 데이터 시각화를 제공합니다: 대형 거래를 위한 다크 풀 소나, CCXT 오더북을 통한 유동성 고갈 추적 플래시 크래시 예측 매트릭스, 상위 50개 암호화폐를 3D로 매핑하는 갤럭시 뷰, 실시간 뉴스에서 트렌드 키워드를 추출하는 AI 감정 워드 클라우드 구, 이더리움 네트워크 혼잡을 시각화하는 가스 및 네트워크 혼잡 홀로그램, OHLCV 시각화 및 전략 시뮬레이션을 위한 타임머신 백테스트 아레나가 포함됩니다. 멀티 MCP 생태계는 거래 및 시장 데이터(CCXT), 온체인 데이터(ETH 잔액, ERC20, 가스 가격), 기술적 분석(RSI, MACD, SMA, 볼린저 밴드, 몬테카를로 시뮬레이션), 포트폴리오 관리, 시장 통계(CoinGecko), LLM 운영, 알림 및 텔레그램 브로드캐스팅, Freqtrade, OctoBot, Hummingbot, Superalgos 플랫폼과의 통합을 포함한 12개 이상의 MCP 서버를 포함합니다. 시스템은 Python MCP 서버와 Node.js 백엔드를 관리하기 위해 중앙 집중식 .env 구성 파일을 사용하며, 비밀번호로 보호된 백엔드 실행, 실패 시 닫힘 쌍 제한, 최대 거래 금액 제한, 비밀번호 검증을 위한 crypto.timingSafeEqual과 같은 보안 기능을 포함합니다. 주문은 로컬 SQLite 데이터베이스에 기록됩니다. 설치는 자동 install.sh 스크립트 또는 수동 설정을 통해 지원되며, 백엔드용 systemd 서비스 관리를 제공합니다. 프론트엔드는 Vite와 React로 구축되었고 백엔드는 Node.js를 사용합니다. 프로젝트는 Python 3.11 이상과 Node.js 20 이상이 필요합니다. 강조되는 보안 모범 사례에는 테스트넷 키 사용, 저장소에 API 키 미포함, 네트워크 액세스를 로컬 LAN으로 제한, 인증된 역방향 프록시 구현이 포함됩니다.