Alpaca MCP Server

🚀 Alpaca MCP サーバー

このサーバーは、Alpacaのモデルコンテキストプロトコル（MCP）サーバーです。Claudeなどの大規模言語モデル（LLMs）が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. .envファイルを作成し、Alpaca APIの認証情報を追加します：

   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. 「開発者」をクリックし、「設定の編集」をクリックします。
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の最新相場を取得してください」
• 「TSLAの過去10日間の価格動向を表示してください」
• 「MSFTを5株成行で買い注文してください」
• 「TSLAを10株、価格Xで売り注文してください」
• 「すべての未約定注文をキャンセルしてください」

📚 ドキュメント

注意事項

• このサーバーは、有効なAlpaca APIキーが必要です。
• 本番環境でこのツールを使用する場合は、コードを慎重にレビューし、安全性を確保してください。

セキュリティ上の注意

このサーバーを介して送信される命令は常にレビューし、不正な取引や操作を防止してください。