프로젝트 소개

Alpaca MCP Server는 Alpaca의 Trading 및 Market Data API를 위한 공식 Model Context Protocol 서버입니다. 이를 통해 Claude Desktop, Claude Code, Cursor, VS Code, PyCharm, Antigravity를 포함한 MCP 호환 어시스턴트와 IDE가 Alpaca 도구를 검색하고 자연어 요청을 통해 거래 또는 리서치 작업을 수행할 수 있습니다. 버전 2는 FastMCP와 OpenAPI로 구축된 완전한 재작성 버전입니다. v1과 하위 호환되지 않습니다. 도구 이름, 매개변수, 스키마, 구성이 변경되었으므로 업그레이드된 설치에서는 재구성하고, 클라이언트를 재시작하고, 새 세션을 시작해야 합니다. 필요한 경우 V1을 마지막 1.x 릴리스에 고정해 둘 수 있습니다. 서버는 uvx를 사용해 stdio를 통해 로컬에서 실행되거나 Docker로 빌드 및 실행할 수 있습니다. 구성은 MCP 클라이언트 구성의 환경 변수를 통해 제공됩니다. ALPACA_API_KEY와 ALPACA_SECRET_KEY는 필수이며, ALPACA_PAPER_TRADE는 기본값이 true이고, ALPACA_TOOLSETS로 노출되는 기능을 제한할 수 있습니다. README는 서버 자체가 원격 MCP 인증을 제공하지 않으므로 서버를 공용 인터넷에 직접 노출하지 말라고 경고합니다. 노출되는 기능은 계정 및 포트폴리오 정보, 거래, 포지션, 관심목록, 자산 및 시장 상태, 주식 데이터, 암호화폐 데이터, 옵션 데이터, 기업 행동, 뉴스, 채권 데이터, 공매도 차입 가능 물량에 대한 도구셋으로 구성됩니다. 구체적인 작업에는 잔고 및 매수 여력 조회, 포트폴리오 이력 및 계정 활동 조회, 주식/ETF, 암호화폐, 옵션 주문 제출, 주문 교체 또는 취소, 포지션 조회 또는 청산, 옵션 행사, 관심목록 관리가 포함됩니다. 시장 데이터 도구는 과거 및 최신 바, 호가, 체결, 스냅샷, 주문장, 옵션 체인, Greeks, 내재 변동성, 캘린더, 시계, 기업 행동 공지, 뉴스, 채권 호가를 다룹니다. 서버에는 Alpaca 가이드 및 OpenAPI 엔드포인트 참조를 위한 문서 조회 도구도 포함되어 있습니다. 일부 데이터 및 차입 가능 물량 기능은 Alpaca 구독 또는 라이브 계정 자격에 따라 달라집니다. 이 프로젝트는 여러 MCP 클라이언트 설정, 라이브 거래 구성, 도구셋 필터링, 예시 프롬프트, 무결성 검사, 서버 구성 테스트, 페이퍼 API 통합 테스트, 문서 통합 테스트를 포함한 테스트 스위트를 문서화합니다.