hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

Used for loading Alpaca API credentials from environment variables to securely connect to the Alpaca trading platform.
Required for cloning the repository as part of the installation process.
Source for cloning the repository containing the MCP server code.

알파카 MCP 서버

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

특징

📚 Alpaca 문서 - Alpaca SDK 문서에 액세스하여 빌드하세요.
📊 시장 데이터 - 실시간 주식 시세 및 과거 가격 데이터를 받아보세요
💵 계좌 정보 - 잔액, 구매력, 상태를 확인하세요
📈 직책 관리 - 현재 직책과 성과를 확인하세요
🛒 주문하기 - 자연어로 시장가 주문과 지정가 주문을 하세요
📋 주문 관리 - 주문 목록, 추적 및 취소

필수 조건

파이썬 3.10+
알파카 API 키
데스크톱 또는 다른 MCP 클라이언트용 Claude

설치

이 저장소를 복제하세요:지엑스피1
필요한 패키지를 설치하세요:
pip install mcp alpaca-py python-dotenv
Alpaca API 자격 증명으로 .env 파일을 만듭니다.
API_KEY_ID=your_alpaca_api_key API_SECRET_KEY=your_alpaca_secret_key

용법

서버 실행

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

python alpaca_mcp_server.py

데스크톱용 Claude 구성

데스크톱용 Open Claude
설정으로 이동
"개발자"를 클릭한 다음 "구성 편집"을 클릭하세요.
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"
      }
    }
  }
}

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

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

클로드와 같은 LLM이 알파카 거래 API와 상호 작용하여 주식 거래, 포지션 확인, 시장 데이터 가져오기, 자연어로 계정 관리 등을 할 수 있도록 하는 모델 컨텍스트 프로토콜 서버입니다.

Alpaca MCP Server