Guardian MCP

Guardian MCP는 Alpaca 페이퍼 트레이딩을 위한 정책 기반 AI 트레이딩 게이트웨이입니다. AI 에이전트는 주식, ETF, 암호화폐 거래를 제안할 수 있지만, 결정적 규칙이 거래를 차단할지, 인간 검토 대상으로 승인할지, 아니면 Alpaca 페이퍼 트레이딩에 제출할지를 결정합니다.

왜 필요한가

대부분의 AI 트레이딩 데모는 모델에게 너무 많은 권한을 부여합니다. Guardian은 워크플로를 분리합니다:

AI proposes a TradeIntent
Guardian validates the intent
Policy engine approves or blocks
Alpaca paper trading receives only approved low-risk orders
Every decision becomes an audit receipt

Related MCP server: alpaca-mcp-server

현재 범위

• 미국 주식 및 ETF

• BTC/USD, ETH/USD, SOL/USD를 포함한 Alpaca 암호화폐 페어

• 페이퍼 트레이딩 전용

• API 키가 없을 때 모의 Alpaca 실행

• 첫 번째 데모를 위한 로컬 JSON 감사 로그

• 페이퍼 전용 안전 게이트를 위한 공식 Alpaca Skills 정렬

시작하기

npm install
npm run dev

http://localhost:3000을 엽니다.

Alpaca 페이퍼 트레이딩에 연결하려면 .env.local을 생성합니다:

ALPACA_API_KEY=your_key
ALPACA_SECRET_KEY=your_secret
ALPACA_PAPER_BASE_URL=https://paper-api.alpaca.markets
ALPACA_PAPER_TRADE=true
TELEGRAM_BOT_TOKEN=your_botfather_token

Alpaca의 공식 스킬도 APCA_API_KEY_ID와 APCA_API_SECRET_KEY를 사용합니다. Guardian도 해당 이름을 지원합니다.

API 키를 채팅에 붙여넣거나 커밋하지 마세요. Guardian은 실시간 Alpaca 구성을 차단하며 페이퍼 트레이딩만 지원합니다.

데모 흐름

1. 모의 AI 거래 제안을 선택합니다.

2. 가드를 실행합니다.

3. 허용된 거래가 모의 또는 실제 Alpaca 페이퍼 트레이딩에 제출되는 것을 확인합니다.

4. 차단된 거래가 정확한 정책 사유와 함께 기록되는 것을 확인합니다.

Telegram 봇

Guardian은 채팅 우선 데모를 위해 Telegram 봇으로도 실행할 수 있습니다:

npm run telegram

봇 명령어:

/account
/portfolio
/policy
/preview buy SOL/USD 50
/confirm guardian-tg-...

봇은 롱 폴링을 사용하므로 Vercel이 아닌 Google VM에서 실행해야 합니다. 봇은 확인 없이 제출하지 않습니다. /preview는 페이퍼 주문 미리보기를 생성하며, Guardian이 Alpaca 페이퍼 트레이딩에 제출하려면 /confirm이 필요합니다.

VM에서 다른 프로세스와 함께 실행하려면:

pm2 start npm --name guardian-telegram -- run telegram
pm2 save

정책 기본값

• 페이퍼 전용 모드

• 최대 거래 명목 금액: $500

• 인간 승인 필요: $100 초과

• 최대 일일 손실: 2%

• 최대 포지션 노출: 15%

• 최대 암호화폐 거래 명목 금액: $100

• 최대 암호화폐 포트폴리오 노출: 20%

• 암호화폐 쿨다운: 15 minutes

해커톤 피치

Guardian MCP는 AI 트레이딩 에이전트가 계정에 대한 무제한 통제권을 모델에 부여하지 않고도 Alpaca를 통해 작동할 수 있게 합니다. 모델은 조사하고 거래를 제안할 수 있습니다. Guardian은 실행 전에 결정적 사용자 정책을 적용하고 모든 결정을 재생 가능한 감사 추적에 기록합니다.

Alpaca Skills

이 저장소는 Alpaca의 공식 에이전트 스킬과 정렬되어 있습니다. 페이퍼 트레이딩 가드레일과 나머지 Alpaca 관련 작업은 docs/alpaca-skills.md를 참조하세요.

MCP 서버

Guardian은 자체 MCP 서버를 포함합니다:

npm run mcp

도구 이름 및 MCP 클라이언트 구성은 docs/mcp.md를 참조하세요.