알파카 MCP 서버

이는 Alpaca용 모델 컨텍스트 프로토콜(MCP) 서버로, Claude와 같은 LLM이 Alpaca 거래 API와 상호 작용할 수 있도록 합니다. 자연어를 통해 주식 거래, 포지션 확인, 시장 데이터 조회, 계좌 관리 등의 작업을 수행할 수 있습니다.

특징

• 📊 시장 데이터 - 실시간 주식 시세 및 과거 가격 데이터를 받아보세요

• 💵 계좌 정보 - 잔액, 구매력, 상태를 확인하세요

• 📈 직책 관리 - 현재 직책과 성과를 확인하세요

• 🛒 주문하기 - 자연어로 시장가 주문과 지정가 주문을 하세요

• 📋 주문 관리 - 주문 목록, 추적 및 취소

Related MCP server: Alpaca MCP Server

필수 조건

• 파이썬 3.10+

• 알파카 API 키

• 데스크톱 또는 다른 MCP 클라이언트용 Claude

설치

1. 이 저장소를 복제하세요:

   지엑스피1

2. 필요한 패키지를 설치하세요:

   pip install mcp alpaca-py python-dotenv

3. Alpaca API 자격 증명으로 .env 파일을 만듭니다.

   API_KEY_ID=your_alpaca_api_key
   API_SECRET_KEY=your_alpaca_secret_key

용법

서버 실행

다음을 실행하여 서버를 시작합니다.

python alpaca_mcp_server.py

데스크톱용 Claude 구성

1. 데스크톱용 Open Claude

2. 설정으로 이동

3. "개발자"를 클릭한 다음 "구성 편집"을 클릭하세요.

4. claude_desktop_config.json 에 서버 구성을 추가합니다.

{
  "mcpServers": {
    "alpaca": {
      "command": "python",
      "args": [
        "/path/to/alpaca_mcp_server.py"
      ],
      "env": {
        "API_KEY_ID": "your_alpaca_api_key",
        "API_SECRET_KEY": "your_alpaca_secret_key"
      }
    }
  }
}

5. Claude for Desktop을 저장하고 다시 시작하세요.

사용 가능한 도구

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

• get_account_info() - 계좌 잔액 및 상태 가져오기

• get_positions() - 포트폴리오의 모든 현재 포지션을 나열합니다.

• get_stock_quote(symbol) - 주식에 대한 최신 견적을 받습니다.

• get_stock_bars(symbol, days) - 주식의 과거 가격 막대를 가져옵니다.

• get_orders(status, limit) - 지정된 상태의 주문 나열

• place_market_order(symbol, side, quantity) - 시장가 주문을 넣습니다.

• place_limit_order(symbol, side, quantity, limit_price) - 제한 주문을 합니다.

• cancel_all_orders() - 모든 미결 주문 취소

• close_all_positions(cancel_orders) - 모든 미결 포지션을 닫습니다.

예제 쿼리

서버가 Claude에 연결되면 다음과 같은 질문을 할 수 있습니다.

• "현재 계좌 잔액과 구매력은 얼마인가요?"

• "내 현재 위치를 보여주세요"

• "AAPL의 최신 견적을 받으세요"

• "지난 10일간 TSLA 가격 내역을 보여주세요"

• "MSFT 주식 5주를 시장 가격으로 매수하세요"

• "130달러 제한 가격으로 AMZN 주식 10주 매도"

• "내 모든 미결 주문 취소"

메모

이 서버는 기본적으로 Alpaca의 페이퍼 트레이딩을 사용합니다. 실제 현금 트레이딩을 사용하려면 TradingClient 초기화에서 paper=True 를 paper=False 변경하세요.

보안 공지

이 MCP 서버는 알파카 계정에 접근하여 실제 거래를 진행할 수 있습니다. 거래를 승인하기 전에 클로드의 제안을 항상 확인하세요.

특허

MIT