Guardian MCP

Guardian MCP ist ein richtliniengebundenes KI-Handels-Gateway für Alpaca-Paper-Trading. KI-Agenten können Aktien-, ETF- und Krypto-Trades vorschlagen, aber deterministische Regeln entscheiden, ob der Trade blockiert, zur menschlichen Überprüfung freigegeben oder an das Alpaca-Paper-Trading übermittelt wird.

Warum es das gibt

Die meisten KI-Handels-Demos geben dem Modell zu viel Befugnis. Guardian trennt den Workflow:

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

Aktueller Umfang

• US-Aktien und ETFs

• Krypto-Paare bei Alpaca, einschließlich BTC/USD, ETH/USD und SOL/USD

• Nur Paper-Trading

• Mock-Alpaca-Ausführung, wenn API-Schlüssel fehlen

• Lokales JSON-Auditprotokoll für die erste Demo

• Ausrichtung an den offiziellen Alpaca-Skills für Paper-only-Sicherheitskontrollen

Erste Schritte

npm install
npm run dev

Öffne http://localhost:3000.

Um Alpaca-Paper-Trading zu verbinden, erstelle .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

Auch die offiziellen Alpaca-Skills verwenden APCA_API_KEY_ID und APCA_API_SECRET_KEY; Guardian unterstützt diese Namen ebenfalls.

Füge API-Schlüssel nicht in den Chat ein und übertrage sie nicht in ein Repository. Guardian blockiert die Live-Alpaca-Konfiguration und unterstützt nur Paper-Trading.

Demo-Ablauf

1. Wähle einen Mock-KI-Trade-Vorschlag aus.

2. Führe den Guard aus.

3. Sieh, wie erlaubte Trades an Mock- oder echtes Alpaca-Paper-Trading übermittelt werden.

4. Sieh, wie blockierte Trades mit genauen Richtlinienbegründungen protokolliert werden.

Telegram-Bot

Guardian kann für die Chat-first-Demo auch als Telegram-Bot laufen:

npm run telegram

Bot-Befehle:

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

Der Bot verwendet Long Polling und sollte daher auf Ihrer Google-VM laufen, nicht auf Vercel. Er übermittelt nie stillschweigend: /preview erstellt die Paper-Order-Vorschau, und /confirm ist erforderlich, bevor Guardian an das Alpaca-Paper-Trading übermitteln kann.

Um neben einem anderen Prozess auf der VM zu laufen:

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

Richtlinien-Standardwerte

• Nur-Paper-Modus

• Maximaler Trade-Nominalwert: $500

• Menschliche Freigabe ab: $100

• Maximaler Tagesverlust: 2%

• Maximale Positions-Exposition: 15%

• Maximaler Krypto-Trade-Nominalwert: $100

• Maximale Krypto-Portfolio-Exposition: 20%

• Krypto-Abklingzeit: 15 Minuten

Hackathon-Pitch

Guardian MCP ermöglicht es KI-Handelsagenten, über Alpaca zu agieren, ohne dem Modell unkontrollierte Kontrolle über ein Konto zu geben. Das Modell kann Trades recherchieren und vorschlagen; Guardian setzt vor der Ausführung deterministische Benutzerrichtlinien durch und zeichnet jede Entscheidung in einem reproduzierbaren Audit-Trail auf.

Alpaca-Skills

Dieses Repository ist auf die offiziellen Agenten-Skills von Alpaca ausgerichtet. Siehe docs/alpaca-skills.md für die Paper-Trading-Sicherheitsvorgaben und die verbleibende Alpaca-spezifische Arbeit.

MCP-Server

Guardian enthält einen eigenen MCP-Server:

npm run mcp

Siehe docs/mcp.md für Tool-Namen und MCP-Client-Konfiguration.