알파카 MCP 서버

Alpaca Market Data & Broker API를 MCP 도구로 공개합니다.

설치

지엑스피1

Related MCP server: Financial Datasets MCP Server

지역 개발

git clone <repo-url>
cd alpaca-mcp
npm install

환경 변수

프로젝트 루트에 .env 생성합니다.

ALPACA_ENDPOINT=https://data.alpaca.markets
ALPACA_BROKER_ENDPOINT=https://broker-api.alpaca.markets
ALPACA_API_KEY=YOUR_ALPACA_API_KEY
ALPACA_SECRET_KEY=YOUR_ALPACA_SECRET_KEY

명령

시작 (dev): npm start ( npx tsx index.ts 실행)
build : npm run build ( dist/ 에 컴파일)
컴파일된 실행 : node dist/index.js

용법

MCP 서버를 실행하면 stdin/stdout에서 수신 대기합니다. MCP 클라이언트나 CLI를 사용하세요.

npm link      # optional
alpaca-mcp    # starts server globally

사용 가능한 도구

get-asset { assetClass?: "us_equity" | "crypto" }
get-stock-bars { symbols: string[]; start: string; end: string; timeframe: string }
get-market-days { start: string; end: string }
뉴스 받기 { start: string; end: string; symbols: string[] }

각각은 content[0].text 의 JSON 또는 오류를 반환합니다.

MCP 클라이언트 구성

mcp.config.json 통해 통합하려면 mcpServers 키 아래에 다음을 추가합니다.

{
  "mcpServers": {
    "alpaca-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "alpaca-mcp"
      ],
      "env": {
        "ALPACA_ENDPOINT": "https://data.alpaca.markets",
        "ALPACA_BROKER_ENDPOINT": "https://broker-api.alpaca.markets",
        "ALPACA_API_KEY": "<YOUR_API_KEY>",
        "ALPACA_SECRET_KEY": "<YOUR_SECRET_KEY>"
      }
    }
  }
}

## Publishing

```bash
npm publish