Alpaca MCP Server

Alpaca MCP サーバー

これは Alpaca 用の Model Context Protocol (MCP) サーバーで、Claude などの LLM が Alpaca の取引 API とやり取りできるようにします。自然言語を通じて、株式の取引、ポジションの確認、市場データの取得、アカウントの管理が可能です。

機能

• 📊 市場データ - リアルタイムの株価引用と過去の価格データを取得
• 💵 アカウント情報 - 残高、買付余力、ステータスを確認
• 📈 ポジション管理 - 現在のポジションとそのパフォーマンスを表示
• 🛒 注文の発注 - 自然言語を通じて成行注文と指値注文を発注
• 📋 注文管理 - 注文の一覧表示、追跡、キャンセル

前提条件

• Python 3.10+
• Alpaca API キー
• Claude for Desktop または別の MCP クライアント

インストール

1. このリポジトリをクローンします:

   git clone https://github.com/YOUR_USERNAME/alpaca-mcp.git
   cd alpaca-mcp
   

2. 必要なパッケージをインストールします:

   pip install mcp alpaca-py python-dotenv
   

3. Alpaca API の認証情報を含む .env ファイルを作成します:

   API_KEY_ID=your_alpaca_api_key
   API_SECRET_KEY=your_alpaca_secret_key
   

使い方

サーバーの実行

次を実行してサーバーを起動します:

python alpaca_mcp_server.py

Claude for Desktop の設定

1. Claude for Desktop を開きます
2. 設定に移動します
3. 「Developer」をクリックし、次に「Edit Config」をクリックします
4. claude_desktop_config.json にサーバー設定を追加します:

{
  "mcpServers": {
    "alpaca": {
      "command": "python",
      "args": [
        "/path/to/alpaca_mcp_server.py"
      ],
      "env": {
        "API_KEY_ID": "your_alpaca_api_key",
        "API_SECRET_KEY": "your_alpaca_secret_key"
      }
    }
  }
}

5. 保存して Claude for Desktop を再起動します

利用可能なツール

サーバーは以下のツールを公開しています:

• get_account_info() - アカウントの残高とステータスを取得
• get_positions() - ポートフォリオ内の現在のすべてのポジションを一覧表示
• get_stock_quote(symbol) - 株式の最新の引用を取得
• get_stock_bars(symbol, days) - 株式の過去の価格バーを取得
• get_orders(status, limit) - 指定したステータスの注文を一覧表示
• place_market_order(symbol, side, quantity) - 成行注文を発注
• place_limit_order(symbol, side, quantity, limit_price) - 指値注文を発注
• cancel_all_orders() - すべての未約定注文をキャンセル
• close_all_positions(cancel_orders) - すべてのオープンポジションを決済

クエリの例

サーバーが Claude に接続されたら、次のような質問ができます:

• 「私の現在の口座残高と買付余力はいくらですか？」
• 「現在のポジションを表示して」
• 「AAPL の最新の引用を取得して」
• 「過去 10 日間の TSLA の価格履歴を表示して」
• 「MSFT の株式を 5 株成行価格で購入して」
• 「AMZN の株式を 10 株、指値価格 $130 で売却して」
• 「未約定の注文をすべてキャンセルして」

注意

このサーバーはデフォルトで Alpaca のペーパートレーディングを使用します。実際の資金で取引するには、TradingClient の初期化で paper=True を paper=False に変更してください。

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

この MCP サーバーはあなたの Alpaca アカウントにアクセスでき、実際の取引を発注できます。取引を承認する前に、Claude が提案している内容を必ず確認してください。

ライセンス

MIT