알파카 트레이딩 MCP 서버

Alpaca 거래 API에 대한 인터페이스를 제공하는 MCP(모델 컨텍스트 프로토콜) 서버로, 이를 통해 주식 및 암호화폐 포트폴리오를 관리하고, 거래를 하고, 시장 데이터에 액세스할 수 있습니다.

특징

• 계정 관리 : 계정 세부 정보, 잔액 및 포트폴리오 상태 보기
• 거래 : 시장가, 지정가, 정지가, 정지가-제한가 주문을 넣습니다.
• 포트폴리오 관리 : 포지션 보기, 성과 계산, 포지션 마감
• 시장 데이터 : 실시간 견적 및 과거 가격 데이터에 액세스하세요
• 자산 정보 : 거래 가능한 자산에 대한 세부 정보를 얻으세요

설치

1. 이 저장소를 복제하세요
2. 종속성 설치:

지엑스피1

또는 uv를 사용하면:

구성

1. .env.example 파일을 .env 로 복사합니다.

2. Alpaca Paper Trading API 자격 증명을 .env 파일에 추가합니다.

이러한 자격 증명은 Alpaca 에 계정을 생성하여 얻을 수 있습니다.

용법

MCP 서버를 실행합니다.

서버가 시작되고 MCP 클라이언트가 연결할 수 있게 됩니다.

사용 가능한 리소스

서버는 다음과 같은 리소스를 제공합니다.

• account://info - 현재 계좌 정보 가져오기
• positions://all - 현재 모든 위치 가져오기
• positions://{symbol} - 특정 심볼에 대한 위치 세부 정보를 가져옵니다.
• orders://recent/{limit} - 지정된 제한을 적용한 최근 주문을 가져옵니다.
• market://{symbol}/quote - 특정 심볼에 대한 현재 시장 견적을 가져옵니다.
• market://{symbol}/bars/{timeframe} - 지정된 기간 동안 특정 심볼에 대한 과거 가격 막대를 가져옵니다.
• assets://list - Alpaca에서 거래 가능한 자산 목록
• assets://{symbol} - 심볼별로 자세한 자산 정보를 가져옵니다.

사용 가능한 도구

서버는 다음과 같은 도구를 제공합니다.

• get_account_info_tool - 현재 계좌 정보 가져오기
• place_market_order - 주식을 매수 또는 매도하기 위한 시장 주문을 합니다.
• place_limit_order - 지정된 가격으로 주식을 매수 또는 매도하기 위한 제한 주문을 합니다.
• place_stop_order - 지정된 가격에 도달하면 주식을 매수 또는 매도하기 위한 정지 주문을 넣습니다.
• place_stop_limit_order - 정지 주문과 제한 주문 기능을 결합한 정지-제한 주문을 합니다.
• cancel_order - ID로 열린 주문을 취소합니다.
• close_position - 특정 심볼에 대한 오픈 포지션을 닫습니다.
• get_portfolio_summary - 포트폴리오의 포괄적인 요약을 받으세요