알파카 MCP 서버
Alpaca Market Data & Broker API를 MCP 도구로 공개합니다.
설치
지엑스피1
지역 개발
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
특허
아이에스씨