Miguelyad26 Alpaca MCP Server

🚀 Alpaca MCP サーバー

このサーバーは、Alpacaに対してモデルコンテキストプロトコル（MCP）を提供し、Claudeなどの大規模言語モデル（LLM）がAlpacaの取引APIと相互作用できるようにします。株式取引、保有状況の確認、市場データの取得、およびアカウント管理を、自然言語ですべて行うことができます。

✨ 主な機能

• 📚 Alpaca ドキュメントアクセス - Alpaca SDK ドキュメントにアクセスして開発を行う
• 📊 市場データ - リアルタイムの株価と過去の価格データを取得する
• 💵 アカウント情報 - 残高、購入力、およびアカウントの状態を確認する
• 📈 保有状況管理 - 現在の保有状況とそのパフォーマンスを確認する
• 🛒 注文発注 - 自然言語で成行注文と指値注文を発注する
• 📋 注文管理 - 注文を一覧表示、追跡、およびキャンセルする

📦 インストール

前提条件

• 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. 「開発者」をクリックし、「設定の編集」を選択します。
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 株買います」
• 「アマゾン（AMZN）の株式を 130 ドルの指値で 10 株売ります」
• 「すべての未約定注文をキャンセルしてください」

⚠️ 重要提示

このサーバーはデフォルトで Alpaca のシミュレーション取引機能を使用しています。実際の資金で取引する場合は、TradingClient の初期化時に paper=True を paper=False に変更してください。

💡 使用建议

この MCP サーバーはあなたの Alpaca アカウントにアクセスし、実際の取引操作を実行することができます。Claude の提案を慎重に確認し、承認する取引が予想通りであることを確認してください。

📄 ライセンス

MIT