この記事で紹介する alpaca-guard-mcp は npm で公開されています。
この記事でわかること
- alpaca-guard-mcp の仕組みとローカルキャップ台帳（cap.json）の構造
- Paper Trading（仮想取引）でリスクなく AI エージェント株取引をテストする方法
- 日次・セッション上限を設定して Claude の暴走を防ぐ安全機構
- Claude Desktop から自然言語で株価確認・発注する実際の会話例
- 本番取引への移行手順（ALPACA_LIVE 環境変数）
はじめに
「Claude に株を買ってきて」——そう話しかけるだけで AI エージェントが発注できたら便利です。でも実際にやろうとすると、不安が頭をよぎります。
- エージェントが暴走して大量発注してしまったら？
- 誤ったシンボルで注文が通ってしまったら？
alpaca-guard-mcp はこうした「エージェントによる株取引の安全弁」として設計された MCP サーバーです。ローカルに置いたキャップ台帳で日次・セッション上限を管理し、デフォルトは paper trading（仮想取引）で動作します。本番取引は環境変数による明示的なオプトインが必要です。
Alpaca とは
Alpaca は米国の証券ブローカーが提供する Commission-free な株取引 API です。Paper Trading は無料・仮想資金で本番同等のテストが可能です。
alpaca-guard-mcp の仕組み
キャップ台帳
発注を許可する前に、ローカルファイル ~/.alpaca-guard/cap.json に記録された累積使用額と上限を照合します。
{
"dailyLimitUsd": 100,
"sessionLimitUsd": 25,
"usedTodayUsd": 12.50,
"usedThisSessionUsd": 12.50,
"resetDate": "2026-05-14"
}
上限を超える注文は拒否され、Alpaca の API には一切リクエストが飛びません。
デフォルト: Paper Trading
paper-api.alpaca.markets ← デフォルト（仮想）
api.alpaca.markets ← ALPACA_LIVE=yes-i-understand のときのみ
セットアップ
{
"mcpServers": {
"alpaca-guard": {
"command": "npx",
"args": ["-y", "alpaca-guard-mcp"],
"env": {
"ALPACA_KEY_ID": "PKxxxxxxxxxxxxxxxx",
"ALPACA_SECRET_KEY": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}
}
}
}
利用可能なツール
| ツール名 | 説明 |
|---|---|
setup |
現在の設定・モードを確認 |
guard_status |
キャップ残高・本日の使用額を確認 |
guard_set_limit |
日次・セッション上限を変更 |
get_quote |
銘柄の現在価格を取得 |
list_supported_stocks |
取引可能な銘柄一覧 |
guarded_buy_stock |
キャップチェック付き成行買い注文 |
guarded_sell_stock |
キャップチェック付き成行売り注文 |
get_positions |
保有ポジション一覧 |
Paper Trading で動かしてみる
AAPL の現在価格を調べて、$10 分 paper trading で買ってみて
Claude が自動で guard_status → get_quote → guarded_buy_stock の順に実行します。
レスポンス例
{
"orderId": "a1b2c3d4-...",
"symbol": "AAPL",
"side": "buy",
"notional": "10.00",
"status": "pending_new",
"capRemainingTodayUsd": 90.00,
"mode": "paper"
}
本番取引を有効にする
"env": {
"ALPACA_KEY_ID": "PKxx（Live用）",
"ALPACA_SECRET_KEY": "xxxx（Live用）",
"ALPACA_LIVE": "yes-i-understand",
"ALPACA_DAILY_LIMIT_USD": "200"
}
注意事項
日本居住者が Live Trading を行う場合、金融商品取引法上の規制が適用される可能性があります。Paper Trading はシミュレーションのため規制対象外ですが、本番取引前に専門家に確認してください。本記事は技術的な解説であり、投資勧誘ではありません。
リンク
- npm: https://www.npmjs.com/package/alpaca-guard-mcp
- Alpaca 公式: https://alpaca.markets
試したい人へ
英語の Glama Playground が苦手な人は、以下のコマンドで日本のターミナルから動かせます：
npx -y pay-per-call-mcp@latest
# → 8 つのデモ API がすぐ使えます
設定不要、課金なし、サインアップ不要。
よくある質問
Q. alpaca-guard-mcp は日本から使えますか？
A. Paper Trading（仮想取引）は技術検証目的であれば利用可能です。ただし Live Trading（実際の株取引）は日本居住者には金融商品取引法の規制が適用される可能性があります。本番利用前に専門家に確認してください。
Q. キャップ上限を超えた注文はどうなりますか？
A. Alpaca の API にはリクエストが到達しません。MCP サーバー側でブロックされ、BUDGET_EXCEEDED エラーが返ります。エージェントが何度試みても物理的に実行できない設計です。
Q. Paper Trading と Live Trading の切り替え方法は？
A. 環境変数 ALPACA_LIVE=yes-i-understand を追加するだけで切り替わります。意図せず切り替えないよう、文字列を完全に一致させる必要があります。