Guardian MCP

Guardian MCP — это ограниченный политикой ИИ-шлюз для бумажной торговли Alpaca. ИИ-агенты могут предлагать сделки с акциями, ETF и криптовалютами, но детерминированные правила решают, будет ли сделка заблокирована, одобрена для проверки человеком или отправлена в бумажную торговлю Alpaca.

Зачем это нужно

Большинство ИИ-демо для торговли дают модели слишком много полномочий. 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 США

• Криптовалютные пары на Alpaca, включая BTC/USD, ETH/USD и SOL/USD

• Только бумажная торговля

• Имитация исполнения Alpaca при отсутствии ключей API

• Локальный 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. Выберите тестовое предложение сделки от ИИ.

2. Запустите проверку.

3. Просмотрите разрешённые сделки, отправленные в имитационную или реальную бумажную торговлю Alpaca.

4. Просмотрите заблокированные сделки, записанные с точными причинами отказа по политике.

Telegram-бот

Guardian также может работать как Telegram-бот для демонстрации с упором на чат:

npm run telegram

Команды бота:

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

Бот использует long polling, поэтому он должен работать на вашей Google VM, а не на Vercel. Он никогда не отправляет сделки молча: /preview создаёт предварительный просмотр бумажного ордера, а /confirm обязателен, прежде чем Guardian сможет отправить сделку в бумажную торговлю Alpaca.

Чтобы запустить бота рядом с другим процессом на VM:

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

Политика по умолчанию

• Режим только бумажной торговли

• Максимальный номинал сделки: $500

• Одобрение человека для сделок свыше: $100

• Максимальный дневной убыток: 2%

• Максимальная экспозиция по позиции: 15%

• Максимальный номинал криптосделки: $100

• Максимальная экспозиция криптопортфеля: 20%

• Период охлаждения криптосделок: 15 minutes

Питч для хакатона

Guardian MCP позволяет ИИ-агентам для торговли работать через Alpaca, не передавая модели неограниченный контроль над счётом. Модель может проводить исследования и предлагать сделки; Guardian применяет детерминированную пользовательскую политику перед исполнением и записывает каждое решение в воспроизводимый журнал аудита.

Alpaca Skills

Этот репозиторий согласован с официальными навыками агентов Alpaca. См. docs/alpaca-skills.md о защитных ограничениях бумажной торговли и остальной работе, специфичной для Alpaca.

MCP-сервер

Guardian включает собственный MCP-сервер:

npm run mcp

См. docs/mcp.md, где указаны названия инструментов и конфигурация MCP-клиента.