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

• Alpacaの暗号資産ペア（BTC/USD、ETH/USD、SOL/USDを含む）

• ペーパートレードのみ

• 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以上

• 1日の最大損失: 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 を参照してください。