mcpField
A
Alpaca's Official MCP Server

Alpaca's Official MCP Server

ローカル
github.com/alpacahq金融データ1.0k2 日前に更新

Alpaca's Official MCP Server について

Alpaca 公式 MCP サーバーは、Alpaca Trading API を MCP クライアントから利用できるようにするサーバーです。株式、オプション、暗号資産の取引とポートフォリオ管理に対応しています。Claude、Cursor、VS Code などの AI アシスタントから取引操作を行いたい利用者を想定しています。v2 は FastMCP と OpenAPI で書き直されており、v1 のツール名とパラメータは互換性がありません。

主な機能

  1. 01株式、オプション、暗号資産の注文発注
  2. 02口座残高、ポジション、ポートフォリオ履歴の参照
  3. 03リアルタイムと過去の市場データ
  4. 04個別または一括でのキャンセルを含む注文管理
  5. 05ALPACA_TOOLSETS によるツールセットの絞り込み

活用シーン

  1. 01AI アシスタントを通じたペーパー取引または実取引の発注と管理
  2. 02オプション契約、気配値、グリークスの照会
  3. 03市場の開閉時間、取引カレンダー、コーポレートアクションの確認

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
"mcpServers": {
"alpaca-mcp-server-alpacahq": {
"command": "uvx",
"args": [
"alpaca-mcp-server"
],
"env": {
"ALPACA_API_KEY": "<ALPACA_API_KEY>",
"ALPACA_SECRET_KEY": "<ALPACA_SECRET_KEY>"
}
}
}
}
起動コマンドuvx alpaca-mcp-server
設定が必要な環境変数
ALPACA_API_KEYシークレット
ALPACA_SECRET_KEYシークレット

ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
pypialpaca-mcp-server

ツール

44

掲載時のツール一覧 · 2 週間前に更新

このツールにパラメーターはありません。

詳細

Alpaca ロゴ

X Reddit Slack LinkedIn フォーラム ドキュメント Python SDK

Alpaca の Trading API 用の包括的な Model Context Protocol(MCP)サーバーです。Claude、Cursor、VS Code などの AI アシスタントを通じて、自然言語による取引操作を可能にします。株式、オプション、暗号資産、ポートフォリオ管理、リアルタイム市場データに対応しています。

Alpaca MCP Server v2 が登場しました。 このバージョンは、FastMCP と OpenAPI を使用して全面的に書き直されています。v1 からアップグレードする場合は、アップグレードガイドをお読みください。ツール名、パラメーター、設定が変更されています。

目次


V1 からのアップグレード

V2 は FastMCP と OpenAPI を使用して全面的に書き直されています。V1 のツールは V2 には一切存在しません。ツール名、パラメーター、スキーマが変更されています。特定の V1 ツール名やパラメーターに依存する設定の場合、V2 をそのまま置き換えて使用することはできません。

変更点
項目V1V2
ツール名手動で作成(例:get_account_info)仕様に基づき、上書き設定を適用(例:get_account_info — 名前が重複する場合がありますが、スキーマは異なります)
パラメーターカスタムスキーマAlpaca API の仕様に準拠
設定.env + init コマンドMCP クライアント設定内の環境変数のみ
ツールのフィルタリング非対応ALPACA_TOOLSETS 環境変数
許可リスト非対応ALPACA_TOOLSETS を使用してツールを制限
V1 スタイルの使い方を V2 で避ける方法

MCP クライアントは、サーバーからツールを動的に検出します。ツール名を「許可リスト」に登録する設定ファイルはありません。クライアントは、サーバーが公開するツールをそのまま取得します。クライアントや AI アシスタントが V2 を誤って使用しないようにするには、次の点に注意してください。

  1. V1 の設定を再利用しない — V2 は新しいサーバーとして扱ってください。MCP クライアントの設定を新しいコマンド/引数に更新し、.env や init に基づくセットアップは削除してください。
  2. ツールのキャッシュをクリアする — 切り替え後に MCP クライアント(Claude Desktop、Cursor、VS Code など)を再起動し、古いツール一覧ではなく新しい一覧を取得するようにしてください。
  3. 新しいチャット/セッションを開始する — 既存の会話には、古いツール名への参照がキャッシュされている場合があります。新しいチャットを開始して、LLM が現在の V2 ツールとそのスキーマを認識できるようにしてください。
  4. カスタム指示とルールを更新する — Cursor のルール、Claude の指示、その他のプロンプトに、特定の V1 ツール名(例:「get_account_info を使用」)が記載されている場合は、V2 のツール名に合わせて更新するか、該当する記述を削除し、LLM がコンテキストからツールを検出できるようにしてください。
  5. ALPACA_TOOLSETS でツールを制限する — 以前、アシスタントが使用できる機能を制限していた場合、V2 では ALPACA_TOOLSETS 環境変数を使ったサーバー側のフィルタリングに対応しています。ツールセットの一覧は、Configuration > Toolset Filtering を参照してください。
まとめ

V1 との後方互換性はないものとして扱ってください。MCP クライアントを V2 用に再設定して再起動し、新しいセッションを使用してください。現在のツール一覧は、Available Tools セクションを確認してください。

V1 のカスタムワークフローを使用していた場合

使用を許可するツールを文書化していた場合、ツール名を指定して呼び出すスクリプトを作成していた場合、または特定の V1 ツールやパラメーターの形式を前提としたプロンプトを作成していた場合、それらは廃止されたものとして扱ってください。以下に記載されている Available Tools と、サーバーが公開する現在のパラメータースキーマを使って作り直してください。

V1 を使い続ける場合

V1 を使い続ける必要がある場合は、MCP クライアントの設定で最後の V1 リリース(例:uvx alpaca-mcp-server==1.x.x serve)を固定してください。既存のセットアップ向けに、V1 は PyPI で引き続き利用できます。


前提条件

API キーの取得

  1. Alpaca Dashboard にアクセスします
  2. 無料のペーパートレード口座を作成します
  3. ダッシュボードから API キーを生成します

セットアップ

サーバーを MCP クライアントの設定に追加し、クライアントを再起動します。init コマンドも .env ファイルも不要です。認証情報を設定する場所は1 か所だけです。

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json(Mac)または %APPDATA%\Claude\claude_desktop_config.json(Windows)を編集します。

{
  "mcpServers": {
    "alpaca": {
      "command": "uvx",
      "args": ["alpaca-mcp-server"],
      "env": {
        "ALPACA_API_KEY": "your_alpaca_api_key",
        "ALPACA_SECRET_KEY": "your_alpaca_secret_key"
      }
    }
  }
}
Claude Mobile

Claude Mobile にはリモート MCP サーバーが必要です。このパッケージではリモート MCP 認証を設定しないため、Alpaca API キーを使ってインターネットに直接公開しないでください。対応するデスクトップクライアントで、ローカルの stdio セットアップを使用してください。

ChatGPT

ChatGPT にはリモート MCP サーバーが必要です。このパッケージではリモート MCP 認証を設定しないため、Alpaca API キーを使ってインターネットに直接公開しないでください。対応するデスクトップクライアントで、ローカルの stdio セットアップを使用してください。

Cursor

数クリックで Cursor Directory からインストールするか、~/.cursor/mcp.json に追加します。

{
  "mcpServers": {
    "alpaca": {
      "command": "uvx",
      "args": ["alpaca-mcp-server"],
      "env": {
        "ALPACA_API_KEY": "your_alpaca_api_key",
        "ALPACA_SECRET_KEY": "your_alpaca_secret_key"
      }
    }
  }
}
VS Code

プロジェクトのルートに .vscode/mcp.json を作成します。公式ドキュメントを参照してください。

{
  "servers": {
    "alpaca": {
      "type": "stdio",
      "command": "uvx",
      "args": ["alpaca-mcp-server"],
      "env": {
        "ALPACA_API_KEY": "your_alpaca_api_key",
        "ALPACA_SECRET_KEY": "your_alpaca_secret_key"
      }
    }
  }
}
PyCharm

公式ガイドを参照してください。

  1. File → Settings → Tools → Model Context Protocol (MCP) に移動します
  2. 新しいサーバーを追加します:
  • Type:stdio
  • Command:uvx
  • Arguments:alpaca-mcp-server
  1. 環境変数を設定します:
 ALPACA_API_KEY=your_alpaca_api_key
 ALPACA_SECRET_KEY=your_alpaca_secret_key
Claude Code
claude mcp add alpaca --scope user --transport stdio uvx alpaca-mcp-server \
  --env ALPACA_API_KEY=your_alpaca_api_key \
  --env ALPACA_SECRET_KEY=your_alpaca_secret_key

Claude Code CLI で /mcp を実行して確認します。

Antigravity CLI

Antigravity MCP のドキュメントを参照してください。

~/.gemini/antigravity-cli/mcp_config.json(グローバル)または .agents/mcp_config.json(ワークスペース)に追加します:

{
  "mcpServers": {
    "alpaca": {
      "command": "uvx",
      "args": ["alpaca-mcp-server"],
      "env": {
        "ALPACA_API_KEY": "your_alpaca_api_key",
        "ALPACA_SECRET_KEY": "your_alpaca_secret_key"
      }
    }
  }
}
Docker
git clone https://github.com/alpacahq/alpaca-mcp-server.git
cd alpaca-mcp-server
docker build -t mcp/alpaca:latest .

MCP クライアントの設定に追加します:

{
  "mcpServers": {
    "alpaca": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-e", "ALPACA_API_KEY=your_key",
        "-e", "ALPACA_SECRET_KEY=your_secret",
        "-e", "ALPACA_PAPER_TRADE=true",
        "mcp/alpaca:latest"
      ]
    }
  }
}

設定

すべての設定は、MCP クライアントの設定で指定する環境変数を通じて行います。ディスクにファイルが書き込まれることはありません。

変数必須デフォルト説明
ALPACA_API_KEYはい—Alpaca API キー
ALPACA_SECRET_KEYはい—Alpaca シークレットキー
ALPACA_PAPER_TRADEいいえtrueライブ取引では false に設定します
ALPACA_TOOLSETSいいえall有効にするツールセットのカンマ区切りリスト
ライブ取引への切り替え

MCP クライアントの設定で env ブロックを更新し、再起動します:

{
  "env": {
    "ALPACA_API_KEY": "your_live_api_key",
    "ALPACA_SECRET_KEY": "your_live_secret_key",
    "ALPACA_PAPER_TRADE": "false"
  }
}
ツールセットのフィルタリング

デフォルトでは、すべてのツールが有効です。サーバーで特定のツールセットのみを有効にするには、ALPACA_TOOLSETS を設定します:

{
  "env": {
    "ALPACA_API_KEY": "...",
    "ALPACA_SECRET_KEY": "...",
    "ALPACA_TOOLSETS": "stock-data,crypto-data"
  }
}

利用可能なツールセット:

ツールセット説明
account口座情報、設定、ポートフォリオ履歴、取引履歴
trading注文、ポジション、オプションの権利行使
watchlistsウォッチリストの CRUD 操作
assetsアセット検索、オプション契約、カレンダー、時計
stock-data株式のバー、気配値、取引、スナップショット、スクリーナー
crypto-data暗号資産のバー、気配値、取引、スナップショット、板情報
options-dataオプションのバー、気配値、取引、スナップショット、チェーン、取引所コード
corporate-actionsコーポレートアクションの発表
news株式と暗号資産のニュース記事
fixed-income-data債券・国債の気配値
locates空売り用の貸株リクエストと気配値
ReadMe Docs MCP

ドキュメントの対象は Trading API、Market Data API、Authentication API の仕様です。Broker API エンドポイントのドキュメントは意図的にこのサーバーから除外されています。

ReadMe MCP の検索に失敗した場合、ツールの応答には Alpaca の公開ドキュメントへのフォールバックリンクと、llms.txt および llms-full.txt が含まれます。

機能

  • マーケットデータ — 株式、暗号資産、オプションのリアルタイムの気配値、約定、価格バーを取得できます。柔軟な時間枠で過去のデータを取得できます。オプションのギリシャ指標とインプライド・ボラティリティも確認できます。
  • アカウント管理 — 残高、購買余力、アカウントのステータス、ポートフォリオの履歴を確認できます。
  • 注文管理 — 株式、暗号資産、オプションの成行、指値、逆指値、逆指値付き指値、トレーリングストップ注文を発注できます。注文を個別または一括でキャンセルできます。
  • オプション取引 — 満期日、権利行使価格、タイプで契約を検索できます。単一レッグまたは複数レッグの戦略を発注できます。最新の気配値、ギリシャ指標、IVを取得できます。
  • 暗号資産取引 — GTC/IOCに対応した成行、指値、逆指値付き指値注文を発注できます。数量または金額を指定できます。
  • ポジション管理 — ポジションの確認、決済、清算ができます。オプション契約を権利行使できます。
  • ニュース — ティッカーと日付範囲で絞り込めるニュース記事を取得できます。
  • マーケットステータス — 市場の開始・終了時刻、カレンダー、コーポレートアクションを確認できます。
  • ウォッチリスト — ウォッチリストを作成、更新、管理できます。
  • アセット検索 — 株式、ETF、暗号資産、オプションの詳細を条件で絞り込んで検索できます。

プロンプトの例

基本的な取引

  1. Alpaca の現在の口座残高と購買力を教えてください。
  2. Alpaca アカウントの現在のポジションを表示してください。
  3. AAPL を 5 株、成行価格で購入してください。
  4. TSLA を 5 株、指値 300 ドルで売却してください。
  5. すべての未約定の株式注文をキャンセルしてください。
  6. ID が abc123 の注文をキャンセルしてください。
  7. GOOGL のポジションをすべて清算してください。
  8. NVDA のポジションを 10%決済してください。
  9. MSFT を 100 株、450 ドルの指値で購入する注文を出してください。
  10. META を 25 株、成行で売却する注文を出してください。

暗号資産の取引

  1. ETH/USD を 0.01、成行で購入する注文を出してください。
  2. BTC/USD を 0.01、110,000 ドルの指値で売却する注文を出してください。

オプション取引

  1. 来月満期の AAPL オプション契約を表示してください。
  2. AAPL250613C00200000 オプションの最新の気配値を取得してください。
  3. SPY250627P00400000 オプションのスナップショットを取得してください。
  4. 来週満期の QQQ コールを 2 契約、ポジション清算してください。
  5. 来週金曜日満期の AAPL コールオプションを 1 契約、成行で購入する注文を出してください。
  6. TSLA250620P00500000 オプションの Greeks を教えてください。
  7. 現在の市場価格から 5%以内の行使価格を持つ TSLA オプション契約を探してください。
  8. 2025 年 6 月 16 日の週に満期となる、現在の市場価格から 10%以内の SPY コールオプションを取得してください。
  9. 6 月 6 日満期の AAPL オプションを使ってブル・コール・スプレッドを組んでください。行使価格は一方を 190.00、もう一方を 200.00 にします。
  10. NVDA コールオプション契約 NVDA250919C001680 を権利行使してください。

市場情報

最新の 15 分データにアクセスするには、Algo Trader Plus Plan に登録する必要があります。

  1. 今日の市場の開始時刻と終了時刻を教えてください。
  2. 来週の市場カレンダーを表示してください。
  3. 過去 3 か月の AAPL、MSFT、GOOGL の現金配当と株式分割を表示してください。
  4. 過去 1 年間の SPY の配当、分割、合併など、すべてのコーポレートアクションを取得してください。
  5. 今後 6 か月以内に予定されている SPY のコーポレートアクションを教えてください。

過去データとリアルタイムデータ

  1. 過去 5 取引日の AAPL の日次価格履歴を表示してください。
  2. 昨日の TSLA の終値はいくらでしたか?
  3. GOOGL の最新のバーを取得してください。
  4. NVDA の最新の取引価格はいくらでしたか?
  5. MSFT の最新の気配値を表示してください。
  6. AMD の直近 100 件の取引を取得してください。
  7. 過去 2 時間の AMZN の 1 分足バーを表示してください。
  8. 先週火曜日から金曜日までの TSLA の 5 分足のイントラデイバーを取得してください。
  9. AAPL の最新の気配値、取引、分足バー、日足バー、前日の日足バーをすべてまとめた、包括的な株式スナップショットを表示してください。
  10. TSLA、NVDA、MSFT の市場スナップショットを比較し、現在の買値と売値のスプレッド、最新の取引価格、日次パフォーマンスを分析してください。

注文

  1. 今週の未約定注文と約定済み注文をすべて表示してください。
  2. AAPL の注文はありますか?
  3. 過去 3 日間に出した指値注文をすべて一覧表示してください。
  4. すべての注文をステータス「約定済み」で絞り込んでください。
  5. 昨日の注文履歴を取得してください。

ウォッチリスト

現時点では、Alpaca の Trading API 経由で作成した取引ウォッチリストのみ、API を通じて表示および更新できます

  1. AAPL、MSFT、NVDA を含む「Tech Stocks」という新しいウォッチリストを作成してください。
  2. 「Tech Stocks」ウォッチリストに TSLA と AMZN を追加してください。
  3. 「Dividend Picks」ウォッチリストにはどの銘柄が含まれていますか?
  4. 「Growth Portfolio」ウォッチリストから META を削除してください。
  5. 既存のウォッチリストをすべて一覧表示してください。

資産情報

  1. 資産「AAPL」の詳細を検索してください。
  2. 取引高上位 5 件の取引可能な暗号資産を表示してください。
  3. NASDAQ の米国株式アクティブ資産をすべて取得し、取引可能な証券のみを表示するように絞り込んでください。

複合シナリオ

  1. 今日の市場の取引時間を取得し、TSLA を 340 ドルの指値で購入する注文を出す前に、購買力を表示してください。
  2. 7 月 3 日満期の SPY オプションを使ってブル・コール・スプレッドを組んでください。現在の SPY 価格より 5%高いコールを 1 契約売却し、3%低いコールを 1 契約購入してください。

利用可能なツール

口座とポートフォリオ

  • get_account_info — 残高、証拠金、口座ステータス
  • get_account_config — 取引制限、証拠金設定、PDT チェック
  • update_account_config — 口座構成設定を更新
  • get_portfolio_history — 時間経過に伴う純資産と損益
  • get_account_activities — 約定、配当、振替
  • get_account_activities_by_type — 種類でフィルタリングされたアクティビティ

取引(注文)

  • get_orders — フィルターを使用して注文を取得
  • get_order_by_id — ID で単一の注文を取得
  • get_order_by_client_id — クライアント注文 ID で単一の注文を取得
  • replace_order_by_id — 既存の未約定注文を置き換え
  • cancel_order_by_id — 特定の注文をキャンセル
  • cancel_all_orders — すべての未約定注文をキャンセル
  • place_stock_order — 株式/ETF(成行、指値、逆指値、逆指値指値、トレーリングストップ、ブラケット)
  • place_crypto_order — 暗号資産(成行、指値、逆指値指値)
  • place_option_order — オプション(シングルレッグまたはマルチレッグ)

ポジション

  • get_all_positions — 現在のすべてのポジション
  • get_open_position — 特定のポジションの詳細
  • close_position — 特定のポジションをクローズ
  • close_all_positions — ポートフォリオ全体を清算
  • exercise_options_position — 保有するオプション契約を行使
  • do_not_exercise_options_position — 不行使の指示

ウォッチリスト

  • create_watchlist — 新しいウォッチリストを作成
  • get_watchlists — すべてのウォッチリストを一覧表示
  • get_watchlist_by_id — 特定のウォッチリストを取得
  • update_watchlist_by_id — ウォッチリストを更新
  • delete_watchlist_by_id — ウォッチリストを削除
  • add_asset_to_watchlist_by_id — ウォッチリストに資産を追加
  • remove_asset_from_watchlist_by_id — ウォッチリストから資産を削除

資産と市場情報

  • get_all_assets — オプションのフィルタリングを使用して資産を一覧表示
  • get_asset — 特定の資産の詳細情報
  • get_option_contracts — 原資産シンボルのオプション契約
  • get_option_contract — シンボルまたは ID で単一のオプション契約を取得
  • get_calendar — 指定した期間の市場カレンダー
  • get_clock — 現在の市場ステータスと次の寄付/引け
  • get_corporate_action_announcements — コーポレートアクションの発表
  • get_corporate_action_announcement — ID で単一の発表を取得

株式データ

  • get_stock_bars — 過去の OHLCV バー
  • get_stock_quotes — 過去の買値/売値気配
  • get_stock_trades — 過去の約定
  • get_stock_latest_bar — 最新の分足バー
  • get_stock_latest_quote — 最新の気配
  • get_stock_latest_trade — 最新の約定
  • get_stock_snapshot — 総合的なスナップショット
  • get_most_active_stocks — 出来高/約定件数別の最も活発な銘柄
  • get_market_movers — 上昇率と下落率の上位銘柄

暗号資産データ

  • get_crypto_bars — 過去の OHLCV バー
  • get_crypto_quotes — 過去の気配
  • get_crypto_trades — 過去の約定
  • get_crypto_latest_bar — 最新の分足バー
  • get_crypto_latest_quote — 最新の気配
  • get_crypto_latest_trade — 最新の約定
  • get_crypto_snapshot — 総合的なスナップショット
  • get_crypto_latest_orderbook — 最新のオーダーブック

オプションデータ

  • get_option_bars — 過去の OHLCV バー
  • get_option_trades — 過去の約定
  • get_option_latest_trade — 最新の約定
  • get_option_latest_quote — 買値/売値と取引所情報を含む最新の気配
  • get_option_snapshot — ギリシャ文字と IV を含むスナップショット
  • get_option_chain — 原資産の完全なオプションチェーン
  • get_option_exchange_codes — 取引所コードと名称のマッピング

コーポレートアクション

  • get_corporate_actions — 市場データからのコーポレートアクションの発表

ニュース

  • get_news — 株式と暗号資産のニュース記事

債券データ

  • get_fixed_income_latest_quotes — ISIN 別の債券の最新気配

ロケート(空売り) — ペーパートレードでは利用できません

  • get_locates — ステータス、シンボル、または日付範囲でフィルタリングされたロケートリクエストを一覧表示
  • create_locate — 空売りのためのロケートリクエストを作成
  • get_locate — ID で単一のロケートリクエストを取得
  • get_locate_quotes — シンボルのロケート可用性と価格を取得

ドキュメント

  • search_alpaca_docs — Alpaca のドキュメントページとガイドを検索します
  • fetch_alpaca_doc — ページ ID を指定して、Alpaca の ReadMe ドキュメントページを 1 つ取得します
  • search_alpaca_api_specs — トピック、パス、パラメーター、スキーマ用語で Alpaca API リファレンスのエンドポイントを検索します
  • list_alpaca_api_endpoints — 許可された Alpaca OpenAPI 仕様を 1 つ指定して、エンドポイントの一覧を表示します
  • get_alpaca_endpoint_docs — メソッドとパスを指定して、Alpaca API の正確なエンドポイント 1 つに関するリファレンスドキュメントを取得します

テスト

このプロジェクトには、プルリクエストのたびに CI で実行される多層テストスイートが含まれています。

  • 整合性テスト — OpenAPI 仕様、ツールセット定義、ツール名/説明のオーバーライド間の整合性を検証します。ネットワークや認証情報は不要です。
  • サーバー構築テスト — モック認証情報を使ってサーバーを構築し、公開されるツールの数が正しいことを確認します。ネットワークは不要です。
  • ペーパー API 統合テスト — Alpaca のペーパートレード API に実際にリクエストを送信し、口座情報、市場データ、注文のライフサイクル、ウォッチリスト、ポジションなどをテストします。ALPACA_API_KEY と ALPACA_SECRET_KEY が必要です。
  • ReadMe 統合テスト — Alpaca の ReadMe MCP に対して、ドキュメント検索の実リクエストを実行します。ローカルで実行する場合は ALPACA_RUN_README_INTEGRATION=true が必要です。

テストスイート全体をローカルで実行するには、次のコマンドを使用します。

# Core tests (no credentials needed)
pytest tests/test_integrity.py tests/test_server_construction.py -v

# Integration tests (requires paper API keys)
ALPACA_API_KEY=... ALPACA_SECRET_KEY=... pytest tests/ -m integration -v

# ReadMe docs integration tests (requires network, no Alpaca credentials)
ALPACA_RUN_README_INTEGRATION=true pytest tests/test_readme_integration.py -v

プロジェクト構成

alpaca-mcp-server/
├── src/
│   └── alpaca_mcp_server/
│       ├── __init__.py
│       ├── cli.py            ← CLI entry point
│       ├── server.py         ← FastMCP server built from OpenAPI specs
│       ├── tool_registry.py  ← Tool names, descriptions, and output risk classifications
│       ├── toolsets.py       ← Toolset → operationId allowlists
│       ├── overrides.py      ← Hand-crafted tools for complex trading endpoints
│       ├── market_data_overrides.py ← Hand-crafted tools for historical data
│       ├── readme_docs.py    ← Read-only proxy tools for Alpaca ReadMe docs
│       └── specs/
│           ├── trading-api.json
│           └── market-data-api.json
├── tests/
│   ├── conftest.py           ← Shared fixtures and paper-account cleanup
│   ├── test_integrity.py     ← Spec ↔ toolset ↔ names consistency checks
│   ├── test_server_construction.py ← Server build verification
│   ├── test_readme_integration.py ← Live ReadMe docs MCP integration tests
│   └── test_paper_integration.py   ← Paper API integration tests
├── scripts/
│   └── sync-specs.sh        ← Download latest OpenAPI specs
├── .github/
│   └── workflows/
│       ├── ci.yml            ← CI pipeline (core + integration)
│       └── publish-pypi.yml  ← PyPI publish on GitHub Release
├── AGENTS.md                 ← Instructions for coding agents
├── pyproject.toml
└── README.md

トラブルシューティング

  • uv/uvx が見つからない:公式ガイド(https://docs.astral.sh/uv/getting-started/installation/)に従って uv をインストールし、uv/uvx が PATH に追加されるよう、ターミナルを再起動してください。
  • 認証情報が不足している:クライアントの env ブロックに ALPACA_API_KEY と ALPACA_SECRET_KEY を設定してください。デフォルトではペーパーモードが ALPACA_PAPER_TRADE = True になります。
  • クライアントが新しい設定を読み込まない:変更後にクライアント(Cursor、Claude Desktop、VS Code)を再起動してください。
  • HTTP ポートの競合:--transport streamable-http を使う場合は、--port を空いているポートに変更してください。

免責事項

当社の MCP サーバーおよび接続された AI エージェントが生成するインサイトは、教育および情報提供のみを目的としており、投資助言として受け取るべきではありません。Alpaca は、特定の証券や投資戦略を推奨していません。意思決定を行う前に、ご自身で十分な調査を行ってください。ここで言及されている各社は独立して運営されており、互いに対して責任を負いません。

オプション取引には本質的に高いリスクが伴い、大きな損失につながる可能性があるため、すべての投資家に適しているわけではありません。オプションに投資する前に、「標準化オプションの特性とリスク」(オプション開示文書)をお読みください。

Alpaca は、第三者コンテンツの作成、編集、推奨、承認を行いません。Alpaca は第三者コンテンツの正確性、適時性、完全性、有用性を保証せず、第三者のサイト上または第三者のサイトから利用可能なコンテンツ、広告、製品、その他の資料について責任を負いません。

すべての投資にはリスクが伴います。証券や金融商品について、過去の運用実績は将来の成果や利益を保証するものではありません。投資戦略がその目標を達成する保証はありません。分散投資は利益を保証するものでも、損失を防ぐものでもない点にご注意ください。証券やその他の金融商品に投資すると、常に損失が発生する可能性があります。投資家は投資する前に、投資目的とリスクを慎重に検討してください。 アルゴリズムの計算は過去およびリアルタイムの市場データに基づいていますが、急激な価格変動、流動性の制約、約定の遅延など、すべての市場要因が考慮されるとは限りません。ボラティリティの推定や配当の扱いなど、モデルの前提条件がパフォーマンスや精度に影響する可能性があります。アルゴリズムが生成した取引は、証券会社の執行プロセス、市場の流動性、注文の優先順位、タイミングの遅延の影響を受けます。これらの要因により、予想される取引の約定価格や約定時刻と異なる場合があります。ユーザーは、アルゴリズムの稼働状況を監視し、関連するリスクを理解する責任を負います。Alpacaは、本システムの使用によって生じた損失について責任を負いません。

過去の仮想バックテスト結果は将来のリターンを保証するものではなく、実際の結果は分析結果と異なる場合があります。

Paper Trading APIはAlpacaDB, Inc.が提供するものであり、実際の資金は必要とせず、ユーザーが市場で実際の証券を取引することもできません。Paper Trading APIの利用を提供することは、AlpacaDB, Inc.またはその関連会社が提示またはいかなる形でも推奨する、いかなる種類の証券、有価証券デリバティブ、先物商品を売買するための申し出も勧誘も、またはいかなる種類の取引もしくは投資に関する助言、推奨、戦略でもありません。また、Paper Trading APIを通じて提供される情報は、AlpacaDB, Inc.またはその関連会社(総称して「Alpaca」)が事業を行う権限を有していない法域における、いかなる種類の申し出や勧誘でもありません。

証券仲介サービスは、AlpacaDB, Inc.の完全子会社であり、FINRA/SIPCの会員であるAlpaca Securities LLC(「Alpaca Securities」)が提供します。テクノロジーおよびサービスはAlpacaDB, Inc.が提供します。

暗号資産サービスは、FinCENに登録された資金移動業者(NMLS # 2160858)であり、AlpacaDB, Inc.の完全子会社であるAlpaca Crypto LLC(「Alpaca Crypto」)が提供します。Alpaca CryptoはSIPCまたはFINRAの会員ではありません。暗号資産は株式ではなく、お客様の暗号資産への投資はFDICまたはSIPCのいずれによっても保護されません。暗号資産は価格変動が激しく、投機性が高いため、重大な損失リスクを伴い、FDICまたは政府機関の保険対象ではありません。お客様は、元本を失う可能性、サイバーセキュリティに関する考慮事項、規制の動向、デジタル資産技術の変化する性質など、これらのサービスを利用する前にさまざまなリスクを認識しておく必要があります。暗号資産のリスクに関する詳細は、こちらをご覧ください。

これは、Alpaca SecuritiesまたはAlpaca Cryptoが該当する法域で登録もしくはライセンスを取得していない場合に、証券もしくは暗号資産の売買、または証券口座もしくは暗号資産口座の開設を勧誘する申し出でも、そのような申し出でも、助言でもありません。

プライバシーポリシー

Alpacaによるお客様のデータの取り扱いについては、以下をご確認ください。

データ収集
  • 収集するデータ:API 呼び出し時のユーザーエージェント文字列(APCA-MCP-TRADING/<version>)
  • 利用目的:MCP サーバーの利用状況を特定し、ユーザーエクスペリエンスを向上させるため
  • 第三者との共有:第三者とは共有しません
  • 保持期間:Alpacaの標準データ保持ポリシーに従って保持します
  • オプトアウト:ALPACA_MCP_USER_AGENT環境変数を空文字列に設定すると、User-Agent ヘッダーは送信されません

セキュリティに関する注意

このサーバーは実際の取引を実行し、ポートフォリオにアクセスできます。API キーは機密性の高い認証情報として取り扱ってください。LLM が提案するすべてのアクションを慎重に確認してください。特に、複雑なオプション戦略や複数レッグの取引には注意が必要です。

HTTP トランスポートのセキュリティ:Streamable HTTP のデフォルト設定は localhost(127.0.0.1:8000)で、Host ヘッダーと Origin ヘッダーを検証します。Docker のデフォルトは stdio です。Helm のデフォルトは、Ingress が無効の ClusterIP HTTP です。0.0.0.0 にバインドしても、認証は提供されません。このパッケージでは MCP OAuth を設定しないため、パブリックインターネットに直接公開しないでください。標準準拠の MCP 認証を提供する運用者は、FastMCP の FASTMCP_HTTP_ALLOWED_HOSTS に正確な公開ホスト名も設定する必要があります。

サポート

問題やご質問がある場合は、[email protected] までお問い合わせください。

GitHub の課題:https://github.com/alpacahq/alpaca-mcp-server/issues GitHub のプルリクエスト:https://github.com/alpacahq/alpaca-mcp-server/pulls

MCP レジストリのメタデータ

mcp-name: io.github.alpacahq/alpaca-mcp-server

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。