Alpaca Trading MCP Server

Alpaca Trading MCP Server

Alpaca の取引 API へのインターフェースを提供する Model Context Protocol（MCP）サーバーです。株式および暗号資産のポートフォリオ管理、取引の発注、市場データへのアクセスが可能です。

特長

• 口座管理：口座の詳細、残高、ポートフォリオの状況を確認できます
• 取引：成行注文、指値注文、逆指値注文、逆指値付き指値注文を発注できます
• ポートフォリオ管理：保有ポジションの確認、パフォーマンスの計算、ポジションの決済ができます
• 市場データ：リアルタイムの価格情報や過去の価格データにアクセスできます
• アセット情報：取引可能なアセットの詳細を取得できます

インストール

Smithery 経由でのインストール

Smithery 経由で Claude Desktop に Alpaca Trading MCP Server を自動的にインストールするには、次を実行します。

npx -y @smithery/cli install @laukikk/alpaca-mcp --client claude

手動インストール

1. このリポジトリをクローンします
2. 依存関係をインストールします。

pip install -e .

または、uv を使用します。

uv pip install -e .

設定

1. .env.example ファイルを .env にコピーします。

cp .env.example .env

2. Alpaca Paper Trading API の認証情報を .env ファイルに追加します。

ALPACA_PAPER_API_KEY = "your-api-key"
ALPACA_PAPER_API_SECRET = "your-api-secret"

認証情報は、Alpaca でアカウントを作成すると取得できます。

使用方法

MCP サーバーを起動します。

python src/server.py

サーバーが起動し、MCP クライアントから接続できるようになります。

Claude for Desktop でのテスト

設定：

Claude for Desktop アプリの設定をテキストエディターで開きます。ファイルが存在しない場合は作成してください。

• Windows：%APPDATA%\Claude\claude_desktop_config.json
• Mac：~/Library/Application\ Support/Claude/claude_desktop_config.json

Alpaca MCP サーバーの設定を追加します。

{
    "mcpServers": {
        "alpaca": {
            "command": "uv",
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/PARENT/FOLDER/alpaca-mcp-server",
                "run",
                "src/server.py"
            ]
        }
    }
}

MCP サーバー開発者向け：クイックスタート

利用可能なリソース

サーバーは次のリソースを提供します。

• account://info - 現在の口座情報を取得します
• positions://all - 現在のすべてのポジションを取得します
• positions://{symbol} - 指定したシンボルのポジション詳細を取得します
• orders://recent/{limit} - 指定した件数の直近の注文を取得します
• market://{symbol}/quote - 指定したシンボルの現在の市場価格を取得します
• market://{symbol}/bars/{timeframe} - 指定した時間枠のシンボルの過去の価格バーを取得します
• assets://list - Alpaca で取引可能なアセットの一覧を取得します
• assets://{symbol} - シンボルを指定してアセットの詳細情報を取得します

利用可能なツール

サーバーは次のツールを提供します。

• get_account_info_tool - 現在の口座情報を取得します
• place_market_order - 株式の成行買い注文または売り注文を発注します
• place_limit_order - 指定した価格で株式の指値買い注文または売り注文を発注します
• place_stop_order - 指定した価格に達したときに株式を売買する逆指値注文を発注します
• place_stop_limit_order - 逆指値注文と指値注文の機能を組み合わせた注文を発注します
• cancel_order - ID を指定して未約定の注文をキャンセルします
• close_position - 指定したシンボルの保有ポジションを決済します
• get_portfolio_summary - ポートフォリオの包括的な概要を取得します