Alpaca Trading

🚀 Alpaca MCP サーバー

このサーバーは、Alpaca 用に設計されたモデルコンテキストプロトコル (MCP) サーバーです。Claude などの大規模言語モデル (LLLM) が 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 に接続すると、以下のような質問をすることができます：

• 私のアカウントの残高を確認してください。
• 現在のすべてのポジションを一覧表示してください。
• Apple 株式のリアルタイムの相場を取得してください。
• Google 株式の成行注文を発注してください。

注意事項

⚠️ 重要提示

デフォルトでは、サーバーはシミュレーション取引環境を使用します。実際の取引に切り替えるには、関連するドキュメントを参照してください。

💡 使用建议

API の認証情報を慎重に取り扱い、アカウントのセキュリティを確保してください。

📄 ライセンス