Guardian MCP

Guardian MCP es una pasarela de trading con IA limitada por políticas para el trading en papel de Alpaca. Los agentes de IA pueden proponer operaciones de acciones, ETF y criptomonedas, pero unas reglas deterministas deciden si la operación se bloquea, se aprueba para revisión humana o se envía al trading en papel de Alpaca.

Por qué existe esto

La mayoría de las demos de trading con IA dan demasiada autoridad al modelo. Guardian separa el flujo de trabajo:

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

Alcance actual

• Acciones y ETF de EE. UU.

• Pares de criptomonedas en Alpaca, incluidos BTC/USD, ETH/USD y SOL/USD

• Solo trading en papel

• Ejecución simulada de Alpaca cuando faltan las claves de API

• Registro de auditoría JSON local para la primera demo

• Alineación con las Alpaca Skills oficiales para las salvaguardas de solo trading en papel

Primeros pasos

npm install
npm run dev

Abre http://localhost:3000.

Para conectar con el trading en papel de Alpaca, crea el archivo .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

Las skills oficiales de Alpaca también usan APCA_API_KEY_ID y APCA_API_SECRET_KEY; Guardian también admite esos nombres.

No pegues claves de API en el chat ni hagas commit de ellas. Guardian bloquea la configuración en vivo de Alpaca y solo admite trading en papel.

Flujo de la demo

1. Elige una propuesta de operación de IA simulada.

2. Ejecuta la comprobación.

3. Observa las operaciones permitidas enviadas al trading en papel de Alpaca, simulado o real.

4. Observa las operaciones bloqueadas registradas con los motivos exactos de la política.

Bot de Telegram

Guardian también puede ejecutarse como un bot de Telegram para la demo centrada en el chat:

npm run telegram

Comandos del bot:

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

El bot usa long polling, por lo que debe ejecutarse en tu VM de Google, no en Vercel. Nunca envía operaciones en silencio: /preview crea la vista previa de la orden en papel y /confirm es obligatorio antes de que Guardian pueda enviarla al trading en papel de Alpaca.

Para ejecutarlo junto a otro proceso en la VM:

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

Valores por defecto de la política

• Modo solo trading en papel

• Nocional máximo por operación: $500

• Aprobación humana por encima de: $100

• Pérdida máxima diaria: 2%

• Exposición máxima por posición: 15%

• Nocional máximo por operación de criptomonedas: $100

• Exposición máxima de la cartera de criptomonedas: 20%

• Tiempo de espera para criptomonedas: 15 minutes

Propuesta para el hackathon

Guardian MCP permite que los agentes de trading con IA operen a través de Alpaca sin dar al modelo un control sin supervisión sobre una cuenta. El modelo puede investigar y proponer operaciones; Guardian aplica la política de usuario determinista antes de la ejecución y registra cada decisión en un registro de auditoría reproducible.

Alpaca Skills

Este repositorio está alineado con las skills oficiales de agentes de Alpaca. Consulta docs/alpaca-skills.md para conocer las salvaguardas de trading en papel y el trabajo restante específico de Alpaca.

Servidor MCP

Guardian incluye su propio servidor MCP:

npm run mcp

Consulta docs/mcp.md para ver los nombres de las herramientas y la configuración del cliente MCP.