Alpaca MCP Server

Alpaca MCP Server v2가 출시되었습니다. 이 버전은 FastMCP와 OpenAPI로 완전히 재작성된 버전입니다. v1에서 업그레이드하는 경우 업그레이드 가이드를 읽어 주세요 — 도구 이름, 매개변수, 구성이 변경되었습니다.

목차

• V1에서 업그레이드

• 사전 요구 사항

• API 키 받기

• 설정

• 구성

• 기능

• 예시 프롬프트

• 사용 가능한 도구

• 테스트

• 프로젝트 구조

• 문제 해결

• 공지

Related MCP server: Alpaca MCP Server

V1에서 업그레이드

V2는 FastMCP와 OpenAPI로 구축된 완전한 재작성입니다. V1 도구 중 V2에 존재하는 것은 없습니다 — 도구 이름, 매개변수, 스키마가 모두 변경되었습니다. 설정이 특정 V1 도구 이름이나 매개변수에 의존하는 경우 V2를 대체 솔루션으로 사용할 수 없습니다.

변경 사항

V2에서 V1 스타일 사용을 피하는 방법

MCP 클라이언트는 서버에서 도구를 동적으로 발견합니다. 도구 이름을 "화이트리스트"에 등록하는 구성 파일은 없습니다 — 클라이언트는 서버가 노출하는 도구를 그대로 받습니다. 클라이언트나 AI 어시스턴트가 V2를 잘못 사용하지 않도록 하려면:

1. V1 구성을 재사용하지 마세요 — V2를 새 서버로 취급하세요. MCP 클라이언트 구성을 새 명령/인수로 업데이트하고 .env 또는 init 기반 설정을 제거하세요.

2. 도구 캐시를 지우세요 — 전환 후 MCP 클라이언트(Claude Desktop, Cursor, VS Code 등)를 다시 시작하여 오래된 목록 대신 새 도구 목록을 가져오세요.

3. 새 채팅/세션을 시작하세요 — 기존 대화에는 이전 도구 이름에 대한 캐시된 참조가 있을 수 있습니다. LLM이 현재 V2 도구와 해당 스키마를 볼 수 있도록 새 채팅을 시작하세요.

4. 사용자 지정 지침과 규칙을 업데이트하세요 — 특정 V1 도구 이름(예: "get_account_info 사용")을 언급하는 Cursor 규칙, Claude 지침 또는 기타 프롬프트가 있다면 V2 도구 이름에 맞게 업데이트하거나 해당 참조를 제거하고 LLM이 컨텍스트에서 도구를 발견하도록 하세요.

5. ALPACA_TOOLSETS로 도구를 제한하세요 — 이전에 어시스턴트가 사용할 수 있는 기능을 제한했다면, V2는 ALPACA_TOOLSETS 환경 변수를 통한 서버 측 필터링을 지원합니다. 도구 세트 목록은 구성 > 도구 세트 필터링을 참조하세요.

요약

V1과의 하위 호환성은 없다고 가정하세요. MCP 클라이언트를 V2용으로 재구성하고, 다시 시작하고, 새 세션을 사용하세요. 현재 도구 목록은 사용 가능한 도구 섹션을 확인하세요.

사용자 지정 V1 워크플로가 있는 경우

허용된 도구를 문서화했거나, 이름으로 도구를 호출하는 스크립트를 작성했거나, 특정 V1 도구/매개변수 형태를 중심으로 프롬프트를 구축했다면 — 이를 구식으로 취급하세요. 아래 나열된 사용 가능한 도구와 서버가 노출하는 현재 매개변수 스키마를 사용하여 다시 만드세요.

V1 유지

V1을 유지해야 한다면, MCP 클라이언트 구성에서 마지막 V1 릴리스(예: uvx alpaca-mcp-server==1.x.x serve)로 고정하세요. V1은 기존 설정을 위해 PyPI에서 계속 사용할 수 있습니다.

사전 요구 사항

• Python 3.10 이상 (설치 가이드)

• uv (설치 가이드)

• Alpaca 거래 API 키 (무료 페이퍼 트레이딩 계정)

• MCP 클라이언트 (Claude Desktop, Cursor, VS Code 등)

API 키 받기

1. Alpaca 대시보드를 방문하세요

2. 무료 페이퍼 트레이딩 계정을 만드세요

3. 대시보드에서 API 키를 생성하세요

설정

MCP 클라이언트 구성에 서버를 추가한 후 클라이언트를 다시 시작하세요. init 명령도, .env 파일도 필요 없습니다 — 자격 증명은 한 곳에서만 설정됩니다.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json(Mac) 또는 %APPDATA%\Claude\claude_desktop_config.json(Windows)을 편집하세요:

{
  "mcpServers": {
    "alpaca": {
      "command": "uvx",
      "args": ["alpaca-mcp-server"],
      "env": {
        "ALPACA_API_KEY": "your_alpaca_api_key",
        "ALPACA_SECRET_KEY": "your_alpaca_secret_key"
      }
    }
  }
}

Claude 모바일

Alpaca는 호스팅된 원격 MCP 서버를 제공하지 않습니다. Claude 모바일 앱에서 MCP 서버를 사용하려면 클라우드 제공업체에 원격으로 호스팅한 다음 Claude에서 사용자 지정 커넥터로 추가하세요. 웹에서 연결하면 커넥터가 모바일 앱에 동기화됩니다.

호스팅, 배포, 커넥터 설정에 대한 자세한 내용은 Claude 모바일 앱에서 Alpaca MCP 서버를 원격으로 배포하는 방법을 참조하세요.

ChatGPT

Alpaca는 호스팅된 원격 MCP 서버를 제공하지 않습니다. ChatGPT에서 MCP 서버를 사용하려면 클라우드 제공업체에 원격으로 호스팅한 다음 커넥터로 추가하세요.

호스팅 및 설정 단계는 ChatGPT의 커넥터와 Claude 모바일 배포 가이드를 참조하세요.

Cursor

Cursor 디렉토리에서 몇 번의 클릭으로 설치하거나 ~/.cursor/mcp.json에 추가하세요:

{
  "mcpServers": {
    "alpaca": {
      "command": "uvx",
      "args": ["alpaca-mcp-server"],
      "env": {
        "ALPACA_API_KEY": "your_alpaca_api_key",
        "ALPACA_SECRET_KEY": "your_alpaca_secret_key"
      }
    }
  }
}

VS Code

프로젝트 루트에 .vscode/mcp.json을 만드세요. 공식 문서를 참조하세요.

{
  "mcp": {
    "servers": {
      "alpaca": {
        "type": "stdio",
        "command": "uvx",
        "args": ["alpaca-mcp-server"],
        "env": {
          "ALPACA_API_KEY": "your_alpaca_api_key",
          "ALPACA_SECRET_KEY": "your_alpaca_secret_key"
        }
      }
    }
  }
}

PyCharm

공식 가이드를 참조하세요.

1. 파일 → 설정 → 도구 → Model Context Protocol(MCP)로 이동하세요

2. 새 서버를 추가하세요:

• 유형: stdio

• 명령: uvx

• 인수: alpaca-mcp-server

3. 환경 변수를 설정하세요:

 ALPACA_API_KEY=your_alpaca_api_key
 ALPACA_SECRET_KEY=your_alpaca_secret_key

Claude Code

claude mcp add alpaca --scope user --transport stdio uvx alpaca-mcp-server \
  --env ALPACA_API_KEY=your_alpaca_api_key \
  --env ALPACA_SECRET_KEY=your_alpaca_secret_key

Claude Code CLI에서 /mcp로 확인하세요.

Antigravity CLI

Antigravity MCP 문서를 참조하세요.

~/.gemini/antigravity-cli/mcp_config.json(전역) 또는 .agents/mcp_config.json(작업 공간)에 추가하세요:

{
  "mcpServers": {
    "alpaca": {
      "command": "uvx",
      "args": ["alpaca-mcp-server"],
      "env": {
        "ALPACA_API_KEY": "your_alpaca_api_key",
        "ALPACA_SECRET_KEY": "your_alpaca_secret_key"
      }
    }
  }
}

Docker

git clone https://github.com/alpacahq/alpaca-mcp-server.git
cd alpaca-mcp-server
docker build -t mcp/alpaca:latest .

MCP 클라이언트 구성에 추가하세요:

{
  "mcpServers": {
    "alpaca": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-e", "ALPACA_API_KEY=your_key",
        "-e", "ALPACA_SECRET_KEY=your_secret",
        "-e", "ALPACA_PAPER_TRADE=true",
        "mcp/alpaca:latest"
      ]
    }
  }
}

구성

모든 구성은 MCP 클라이언트 구성에 설정된 환경 변수를 통해 이루어집니다. 디스크에 파일이 기록되지 않습니다.

실거래로 전환

MCP 클라이언트 구성에서 env 블록을 업데이트하고 다시 시작하세요:

{
  "env": {
    "ALPACA_API_KEY": "your_live_api_key",
    "ALPACA_SECRET_KEY": "your_live_secret_key",
    "ALPACA_PAPER_TRADE": "false"
  }
}

도구 세트 필터링

기본적으로 모든 도구가 활성화됩니다. 서버를 특정 도구 세트로 제한하려면 ALPACA_TOOLSETS를 설정하세요:

{
  "env": {
    "ALPACA_API_KEY": "...",
    "ALPACA_SECRET_KEY": "...",
    "ALPACA_TOOLSETS": "stock-data,crypto-data"
  }
}

사용 가능한 도구 세트:

ReadMe 문서 MCP

문서는 거래 API, 시장 데이터 API, 인증 API 사양으로 범위가 제한됩니다. Broker API 엔드포인트 문서는 이 서버에서 의도적으로 제외됩니다.

ReadMe MCP 조회가 실패하면 도구 응답에 Alpaca 공개 문서와 llms.txt 및 llms-full.txt에 대한 대체 링크가 포함됩니다.

기능

• 시장 데이터 — 주식, 암호화폐, 옵션에 대한 실시간 호가, 체결, 가격 바. 유연한 시간대의 과거 데이터. 옵션 그릭스(Greeks)와 내재 변동성.

• 계정 관리 — 잔고, 구매력, 계정 상태, 포트폴리오 내역 확인.

• 주문 관리 — 주식, 암호화폐, 옵션에 대한 시장가, 지정가, 스톱, 스톱-리밋, 트레일링 스톱 주문. 개별 또는 일괄 주문 취소.

• 옵션 거래 — 만기/행사가/유형별 계약 검색. 단일 다리 또는 다중 다리 전략 주문. 최신 호가, 그릭스, IV 확인.

• 암호화폐 거래 — GTC/IOC 시장가, 지정가, 스톱-리밋 주문. 수량 또는 명목 금액 기준.

• 포지션 관리 — 포지션 조회, 청산, 전량 청산. 옵션 계약 행사.

• 뉴스 — 티커와 날짜 범위로 필터링 가능한 뉴스 기사.

• 시장 상태 — 시장 개장/폐장 시간, 달력, 기업 액션.

• 관심 목록 — 관심 목록 생성, 업데이트, 관리.

• 자산 검색 — 필터링을 통한 주식, ETF, 암호화폐, 옵션 세부 정보 조회.

예시 프롬프트

기본 거래

1. 내 Alpaca 계좌의 현재 잔액과 구매력은 얼마인가요?

2. 내 Alpaca 계좌의 현재 포지션을 보여주세요.

3. 시장가로 AAPL 5주를 매수하세요.

4. $300의 지정가로 TSLA 5주를 매도하세요.

5. 모든 미체결 주식 주문을 취소하세요.

6. ID가 abc123인 주문을 취소하세요.

7. GOOGL 포지션 전체를 청산하세요.

8. NVDA 포지션의 10%를 청산하세요.

9. $450에 MSFT 100주를 매수하는 지정가 주문을 넣으세요.

10. META 25주를 매도하는 시장가 주문을 넣으세요.

암호화폐 거래

1. ETH/USD 0.01을 매수하는 시장가 주문을 넣으세요.

2. $110,000에 BTC/USD 0.01을 매도하는 지정가 주문을 넣으세요.

옵션 거래

1. 다음 달 만기인 AAPL 옵션 계약을 보여주세요.

2. AAPL250613C00200000 옵션의 최신 호가를 가져오세요.

3. SPY250627P00400000 옵션의 옵션 스냅샷을 가져오세요.

4. 다음 주 만기인 QQQ 콜 2계약의 포지션을 청산하세요.

5. 다음 주 금요일 만기인 AAPL 콜 옵션 1계약을 매수하는 시장가 주문을 넣으세요.

6. TSLA250620P00500000 옵션의 옵션 그릭스는 무엇인가요?

7. 행사가가 현재 시장가의 5% 이내인 TSLA 옵션 계약을 찾아주세요.

8. 2025년 6월 16일 주에 만기되며 시장가의 10% 이내인 SPY 콜 옵션을 가져오세요.

9. AAPL 6월 6일자 옵션으로 불 콜 스프레드를 구성하세요: 하나는 행사가 190.00, 다른 하나는 행사가 200.00입니다.

10. 내 NVDA 콜 옵션 계약 NVDA250919C001680을 행사하세요.

시장 정보

최신 15분 데이터에 접근하려면 Algo Trader Plus 플랜에 가입해야 합니다.

1. 오늘 시장 개장 및 마감 시간은 언제인가요?

2. 다음 주 시장 캘린더를 보여주세요.

3. 지난 3개월간 AAPL, MSFT, GOOGL의 최근 현금 배당금과 주식 분할을 보여주세요.

4. 지난 1년간 SPY의 배당금, 분할, 합병을 포함한 모든 기업 활동을 가져오세요.

5. 향후 6개월간 SPY에 예정된 기업 활동은 무엇인가요?

과거 및 실시간 데이터

1. 지난 5거래일간 AAPL의 일봉 가격 내역을 보여주세요.

2. 어제 TSLA의 종가는 얼마였나요?

3. GOOGL의 최신 봉을 가져오세요.

4. NVDA의 최신 체결 가격은 얼마였나요?

5. MSFT의 가장 최근 호가를 보여주세요.

6. AMD의 최근 100건의 체결 내역을 가져오세요.

7. 지난 2시간 동안의 AMZN 1분봉을 보여주세요.

8. 지난 화요일부터 지난 금요일까지의 TSLA 5분봉을 가져오세요.

9. 최신 호가, 체결, 분봉, 일봉, 전일 일봉을 한 번에 보여주는 AAPL 종합 주식 스냅샷을 가져오세요.

10. TSLA, NVDA, MSFT의 시장 스냅샷을 비교하여 현재 매수/매도 호가 스프레드, 최신 체결 가격, 일간 성과를 분석하세요.

주문

1. 이번 주의 모든 미체결 및 체결 주문을 보여주세요.

2. AAPL에 대해 어떤 주문이 있나요?

3. 지난 3일간 내가 넣은 모든 지정가 주문을 나열해 주세요.

4. 모든 주문을 상태별로 필터링하세요: 체결됨.

5. 어제의 주문 내역을 가져와 주세요.

관심 종목 목록

현재로서는 Alpaca의 거래 API를 통해 생성된 거래 관심 목록만 API를 통해 조회하고 업데이트할 수 있습니다.

1. "Tech Stocks"라는 새 관심 목록을 AAPL, MSFT, NVDA로 생성하세요.

2. 내 "Tech Stocks" 관심 목록에 TSLA와 AMZN을 포함하도록 업데이트하세요.

3. 내 "Dividend Picks" 관심 목록에는 어떤 주식이 있나요?

4. 내 "Growth Portfolio" 관심 목록에서 META를 제거하세요.

5. 내 기존 관심 목록을 모두 나열해 주세요.

자산 정보

1. 'AAPL' 자산에 대한 세부 정보를 검색하세요.

2. 거래량 기준 상위 5개 거래 가능한 암호화폐 자산을 보여주세요.

3. 모든 NASDAQ 활성 미국 주식 자산을 가져오고 거래 가능한 증권만 표시하도록 결과를 필터링하세요.

복합 시나리오

1. 오늘의 시장 시계를 가져오고 TSLA $340 지정가 매수 주문을 넣기 전에 내 구매력을 보여주세요.

2. SPY 7월 3일자 옵션으로 불 콜 스프레드를 구성하세요: 현재 SPY 가격보다 5% 높은 가격에 하나를 매도하고 3% 낮은 가격에 하나를 매수하세요.

사용 가능한 도구

계정 및 포트폴리오

• get_account_info — 잔액, 마진, 계정 상태

• get_account_config — 거래 제한, 마진 설정, PDT 확인

• update_account_config — 계정 구성 설정 업데이트

• get_portfolio_history — 시간에 따른 자본과 손익

• get_account_activities — 체결, 배당금, 이체

• get_account_activities_by_type — 유형별로 필터링된 활동

거래 (주문)

• get_orders — 필터를 사용하여 주문 검색

• get_order_by_id — ID로 단일 주문 검색

• get_order_by_client_id — 클라이언트 주문 ID로 단일 주문 검색

• replace_order_by_id — 기존 미체결 주문 대체

• cancel_order_by_id — 특정 주문 취소

• cancel_all_orders — 모든 미체결 주문 취소

• place_stock_order — 주식/ETF (시장가, 지정가, 스톱, 스톱-지정가, 트레일링 스톱, 브래킷)

• place_crypto_order — 암호화폐 (시장가, 지정가, 스톱-지정가)

• place_option_order — 옵션 (단일 다리 또는 다중 다리)

포지션

• get_all_positions — 현재 모든 포지션

• get_open_position — 특정 포지션의 세부 정보

• close_position — 특정 포지션 청산

• close_all_positions — 전체 포트폴리오 청산

• exercise_options_position — 보유 중인 옵션 계약 행사

• do_not_exercise_options_position — 행사하지 않음 지시

관심 종목 목록

• create_watchlist — 새 관심 목록 생성

• get_watchlists — 모든 관심 목록 나열

• get_watchlist_by_id — 특정 관심 목록 가져오기

• update_watchlist_by_id — 관심 목록 업데이트

• delete_watchlist_by_id — 관심 목록 삭제

• add_asset_to_watchlist_by_id — 관심 목록에 자산 추가

• remove_asset_from_watchlist_by_id — 관심 목록에서 자산 제거

자산 및 시장 정보

• get_all_assets — 선택적 필터링으로 자산 나열

• get_asset — 특정 자산의 상세 정보

• get_option_contracts — 기초 심볼의 옵션 계약

• get_option_contract — 심볼 또는 ID로 단일 옵션 계약 가져오기

• get_calendar — 날짜 범위에 대한 시장 캘린더

• get_clock — 현재 시장 상태 및 다음 개장/마감

• get_corporate_action_announcements — 기업 활동 공지

• get_corporate_action_announcement — ID로 단일 공지 가져오기

주식 데이터

• get_stock_bars — 과거 OHLCV 봉

• get_stock_quotes — 과거 매수/매도 호가

• get_stock_trades — 과거 체결 내역

• get_stock_latest_bar — 최신 분봉

• get_stock_latest_quote — 최신 호가

• get_stock_latest_trade — 최신 체결

• get_stock_snapshot — 종합 스냅샷

• get_most_active_stocks — 거래량/체결 건수 기준 최다 거래 종목

• get_market_movers — 상승률/하락률 상위 종목

암호화폐 데이터

• get_crypto_bars — 과거 OHLCV 봉

• get_crypto_quotes — 과거 호가

• get_crypto_trades — 과거 체결 내역

• get_crypto_latest_bar — 최신 분봉

• get_crypto_latest_quote — 최신 호가

• get_crypto_latest_trade — 최신 체결

• get_crypto_snapshot — 종합 스냅샷

• get_crypto_latest_orderbook — 최신 호가창

옵션 데이터

• get_option_bars — 과거 OHLCV 봉

• get_option_trades — 과거 체결 내역

• get_option_latest_trade — 최신 체결

• get_option_latest_quote — 매수/매도 호가 및 거래소 정보가 포함된 최신 호가

• get_option_snapshot — 그릭스와 내재변동성이 포함된 스냅샷

• get_option_chain — 기초 자산의 전체 옵션 체인

• get_option_exchange_codes — 거래소 코드-이름 매핑

기업 활동

• get_corporate_actions — 시장 데이터에서 제공하는 기업 활동 공지

뉴스

• get_news — 주식 및 암호화폐 관련 뉴스 기사

채권 데이터

• get_fixed_income_latest_quotes — ISIN별 채권 증권 최신 호가

로케이트 (공매도)

• get_locates — 상태, 심볼 또는 날짜 범위로 필터링된 로케이트 요청 나열

• create_locate — 공매도를 위한 로케이트 요청 생성

• get_locate — ID로 단일 로케이트 요청 가져오기

• get_locate_quotes — 심볼별 로케이트 가용성 및 가격 확인

문서

• search_alpaca_docs — Alpaca 문서 페이지 및 가이드 검색

• fetch_alpaca_doc — 페이지 ID로 Alpaca ReadMe 문서 페이지 하나 가져오기

• search_alpaca_api_specs — 주제, 경로, 매개변수 또는 스키마 용어로 Alpaca API 참조 엔드포인트 검색

• list_alpaca_api_endpoints — 허용된 Alpaca OpenAPI 스펙 하나의 엔드포인트 나열

• get_alpaca_endpoint_docs — 메서드와 경로로 정확한 Alpaca API 엔드포인트 하나의 참조 문서 가져오기

테스트

이 프로젝트는 모든 풀 리퀘스트에서 CI로 실행되는 다층 테스트 스위트를 포함합니다:

• 무결성 테스트 — OpenAPI 스펙, 도구 세트 정의, 도구 이름/설명 재정의 간의 일관성을 검증합니다. 네트워크나 자격 증명이 필요 없습니다.

• 서버 구성 테스트 — 목(mocked) 자격 증명으로 서버를 구축하고 올바른 수의 도구가 노출되는지 확인합니다. 네트워크가 필요 없습니다.

• 페이퍼 API 통합 테스트 — Alpaca 페이퍼 트레이딩 API에 실제 호출을 실행하여 계정 정보, 시장 데이터, 주문 수명 주기, 관심 목록, 포지션 등을 다룹니다. ALPACA_API_KEY와 ALPACA_SECRET_KEY가 필요합니다.

• ReadMe 통합 테스트 — Alpaca의 ReadMe MCP에 실시간 문서 조회 호출을 실행합니다. 로컬에서 실행할 때는 ALPACA_RUN_README_INTEGRATION=true가 필요합니다.

전체 스위트를 로컬에서 실행하세요:

# Core tests (no credentials needed)
pytest tests/test_integrity.py tests/test_server_construction.py -v

# Integration tests (requires paper API keys)
ALPACA_API_KEY=... ALPACA_SECRET_KEY=... pytest tests/ -m integration -v

# ReadMe docs integration tests (requires network, no Alpaca credentials)
ALPACA_RUN_README_INTEGRATION=true pytest tests/test_readme_integration.py -v

프로젝트 구조

alpaca-mcp-server/
├── src/
│   └── alpaca_mcp_server/
│       ├── __init__.py
│       ├── cli.py            ← CLI entry point
│       ├── server.py         ← FastMCP server built from OpenAPI specs
│       ├── tool_registry.py  ← Tool names, descriptions, and output risk classifications
│       ├── toolsets.py       ← Toolset → operationId allowlists
│       ├── overrides.py      ← Hand-crafted tools for complex trading endpoints
│       ├── market_data_overrides.py ← Hand-crafted tools for historical data
│       ├── readme_docs.py    ← Read-only proxy tools for Alpaca ReadMe docs
│       └── specs/
│           ├── trading-api.json
│           └── market-data-api.json
├── tests/
│   ├── conftest.py           ← Shared fixtures and paper-account cleanup
│   ├── test_integrity.py     ← Spec ↔ toolset ↔ names consistency checks
│   ├── test_server_construction.py ← Server build verification
│   ├── test_readme_integration.py ← Live ReadMe docs MCP integration tests
│   └── test_paper_integration.py   ← Paper API integration tests
├── scripts/
│   └── sync-specs.sh        ← Download latest OpenAPI specs
├── .github/
│   └── workflows/
│       └── ci.yml            ← CI pipeline (core + integration)
├── AGENTS.md                 ← Instructions for coding agents
├── pyproject.toml
└── README.md

문제 해결

• uv/uvx를 찾을 수 없음: 공식 가이드(https://docs.astral.sh/uv/getting-started/installation/)에서 uv를 설치한 후 터미널을 다시 시작하여 uv/uvx가 PATH에 있도록 하세요.

• 자격 증명 누락: 클라이언트의 env 블록에 ALPACA_API_KEY와 ALPACA_SECRET_KEY를 설정하세요. 페이퍼 모드 기본값은 ALPACA_PAPER_TRADE = True입니다.

• 클라이언트가 새 구성을 인식하지 못함: 변경 후 클라이언트(Cursor, Claude Desktop, VS Code)를 다시 시작하세요.

• HTTP 포트 충돌: --transport streamable-http를 사용하는 경우 --port를 사용 가능한 포트로 변경하세요.

고지 사항

당사의 MCP 서버와 연결된 AI 에이전트가 생성한 인사이트는 교육 및 정보 제공 목적으로만 제공되며 투자 조언으로 간주되어서는 안 됩니다. Alpaca는 특정 증권이나 투자 전략을 추천하지 않습니다. 결정을 내리기 전에 직접 실사(due diligence)를 수행하시기 바랍니다. 언급된 모든 회사는 독립적으로 운영되며 서로에 대해 책임을 지지 않습니다.

옵션 거래는 내재된 높은 위험으로 인해 상당한 손실을 초래할 수 있으므로 모든 투자자에게 적합하지 않습니다. 옵션에 투자하기 전에 표준화 옵션의 특성 및 위험(옵션 공시 문서)을 읽어보시기 바랍니다.

Alpaca는 제3자 콘텐츠를 작성, 편집, 보증 또는 승인하지 않습니다. Alpaca는 제3자 콘텐츠의 정확성, 적시성, 완전성 또는 유용성을 보장하지 않으며, 제3자 사이트에 있거나 제3자 사이트에서 이용 가능한 콘텐츠, 광고, 제품 또는 기타 자료에 대해 책임을 지지 않습니다.

모든 투자에는 위험이 따르며, 증권 또는 금융 상품의 과거 성과가 미래의 결과나 수익을 보장하지 않습니다. 어떤 투자 전략도 그 목표를 달성할 것이라는 보장은 없습니다. 분산 투자가 수익을 보장하거나 손실을 방지하지 않는다는 점에 유의하시기 바랍니다. 증권이나 기타 금융 상품에 투자할 때는 항상 손실 가능성이 있습니다. 투자자는 투자하기 전에 투자 목표와 위험을 신중히 고려해야 합니다.

알고리즘의 계산은 과거 및 실시간 시장 데이터를 기반으로 하지만 급격한 가격 변동, 유동성 제약 또는 체결 지연을 포함한 모든 시장 요인을 반영하지 못할 수 있습니다. 변동성 추정치나 배당 처리와 같은 모델 가정은 성과와 정확성에 영향을 미칠 수 있습니다. 알고리즘이 생성한 거래는 브로커의 체결 프로세스, 시장 유동성, 주문 우선순위 및 타이밍 지연의 영향을 받습니다. 이러한 요인으로 인해 예상 체결 가격이나 시간과 차이가 발생할 수 있습니다. 사용자는 알고리즘 활동을 모니터링하고 관련된 위험을 이해할 책임이 있습니다. Alpaca는 이 시스템 사용으로 인해 발생한 손실에 대해 책임을 지지 않습니다.

과거의 가상 백테스트 결과는 미래 수익을 보장하지 않으며, 실제 결과는 분석 결과와 다를 수 있습니다.

Paper Trading API는 AlpacaDB, Inc.에서 제공하며 실제 자금을 요구하지 않으며 사용자가 실제 시장에서 실제 유가증권을 거래할 수 있도록 허용하지 않습니다. Paper Trading API 사용을 제공하는 것은 유가증권, 증권 파생상품 또는 모든 종류의 선물 상품의 매수·매도 제안이나 권유, 또는 AlpacaDB, Inc.나 AlpacaDB, Inc. 계열사가 제공하거나 어떤 방식으로든 보증하는 모든 종류의 거래 또는 투자 조언, 권고 또는 전략이 아니며, Paper Trading API를 통해 제공되는 정보는 AlpacaDB, Inc. 또는 AlpacaDB, Inc. 계열사(통칭 "Alpaca")가 사업을 수행할 권한이 없는 모든 관할권에서 어떤 종류의 제안이나 권유도 아닙니다.

증권 중개 서비스는 AlpacaDB, Inc.의 완전 자회사인 Alpaca Securities LLC("Alpaca Securities", FINRA/SIPC 회원)가 제공합니다. 기술 및 서비스는 AlpacaDB, Inc.가 제공합니다.

암호화폐 서비스는 FinCEN 등록 금융 서비스 사업자(NMLS # 2160858)이자 AlpacaDB, Inc.의 완전 자회사인 Alpaca Crypto LLC("Alpaca Crypto")가 제공합니다. Alpaca Crypto는 SIPC 또는 FINRA 회원이 아닙니다. 암호화폐는 주식이 아니며 귀하의 암호화폐 투자는 FDIC 또는 SIPC에 의해 보호되지 않습니다. 암호화폐 자산은 매우 변동성이 크고 투기적이며 상당한 손실 위험을 수반하며 FDIC 또는 정부 기관에 의해 보험 처리되지 않습니다. 고객은 이러한 서비스를 이용하기 전에 원금 손실 가능성, 사이버 보안 고려 사항, 규제 개발, 디지털 자산 기술의 진화하는 특성 등 다양한 위험을 인지해야 합니다. 암호화폐 위험에 대한 추가 정보는 여기를 클릭하십시오.

이는 Alpaca Securities 또는 Alpaca Crypto가 각각 등록되거나 라이선스가 부여되지 않은 모든 관할권에서 유가증권 또는 암호화폐를 매수·매도하거나 중개 계좌 또는 암호화폐 계좌를 개설하라는 제안, 권유 또는 조언이 아닙니다.

개인정보 처리방침

Alpaca가 귀하의 데이터를 처리하는 방법에 대한 정보는 다음을 검토하십시오:

• 개인정보 처리방침

• 공시 자료실

데이터 수집

• 수집 항목: API 호출을 위한 사용자 에이전트 문자열(APCA-MCP-TRADING/<version>)

• 사용 목적: MCP 서버 사용을 식별하고 사용자 경험을 개선하기 위함

• 제3자 공유: 제3자와 공유되지 않음

• 보관 기간: Alpaca의 표준 데이터 보관 정책에 따라 보관

• 거부 방법: ALPACA_MCP_USER_AGENT 환경 변수를 빈 문자열로 설정하면 User-Agent 헤더가 전송되지 않음

보안 공지

이 서버는 실제 거래를 실행하고 귀하의 포트폴리오에 접근할 수 있습니다. API 키를 민감한 자격 증명으로 취급하십시오. 특히 복잡한 옵션 전략 또는 다리( multi-leg) 거래의 경우 LLM이 제안하는 모든 작업을 신중하게 검토하십시오.

HTTP 전송 보안: HTTP 전송을 사용할 때 서버는 보안을 위해 기본적으로 localhost(127.0.0.1:8000)로 설정됩니다. 원격 접속의 경우 --host 0.0.0.0으로 모든 인터페이스에 바인딩하거나, SSH 터널링(ssh -L 8000:localhost:8000 user@server)을 사용하거나, 인증이 포함된 리버스 프록시를 설정하여 안전하게 접근할 수 있습니다.

지원

문제나 질문이 있는 경우 support@alpaca.markets로 연락해 주십시오.

GitHub 이슈: https://github.com/alpacahq/alpaca-mcp-server/issues GitHub 풀 리퀘스트: https://github.com/alpacahq/alpaca-mcp-server/pulls

MCP 레지스트리 메타데이터

mcp-name: io.github.alpacahq/alpaca-mcp-server