Alpaca MCP Server

Alpaca MCP サーバー

Alpaca Trading API 用の Model Context Protocol（MCP）サーバーです。AI アシスタントや開発ツールとシームレスに連携できます。

✅ 互換性

macOS を実行する Apple Silicon M1 Pro 搭載ノートパソコンでテスト済み、動作確認済みです。

機能

• アカウント情報：アカウントの詳細、購買余力、純資産、ステータスをリアルタイムで取得します
• ポートフォリオ管理：損益を追跡しながら、現在のポジションを表示します
• マーケットデータ：売買スプレッドを含む株価をリアルタイムで取得します
• 注文管理：最近の注文を一覧表示し、監視します
• ペーパートレード対応：ペーパートレード API を使った安全なテスト環境です
• ライブトレード対応：ライブトレードと互換性があります（慎重にご利用ください）

インストール

前提条件

pip install alpaca-trade-api

クイックスタート

1. リポジトリをクローンします：

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

2. Alpaca API の認証情報を設定します：

環境変数を作成するか、シェルのプロファイルに追加します：

export APCA_API_KEY_ID="your_api_key_here"
export APCA_API_SECRET_KEY="your_secret_key_here"
export APCA_API_BASE_URL="https://paper-api.alpaca.markets"  # Paper trading
# export APCA_API_BASE_URL="https://api.alpaca.markets"      # Live trading

3. サーバーをテストします：

python alpaca_mcp_server.py

MCP 連携

Cline／Claude Dev Tools の場合

MCP の設定 JSON に追加します：

{
  "mcpServers": {
    "alpaca": {
      "command": "python",
      "args": ["/path/to/alpaca-mcp-server/alpaca_mcp_server.py"],
      "env": {
        "APCA_API_KEY_ID": "your_api_key_here",
        "APCA_API_SECRET_KEY": "your_secret_key_here",
        "APCA_API_BASE_URL": "https://paper-api.alpaca.markets"
      }
    }
  }
}

Claude Desktop の場合

claude_desktop_config.json に追加します：

{
  "mcpServers": {
    "alpaca": {
      "command": "python",
      "args": ["/path/to/alpaca-mcp-server/alpaca_mcp_server.py"],
      "env": {
        "APCA_API_KEY_ID": "your_api_key_here",
        "APCA_API_SECRET_KEY": "your_secret_key_here",
        "APCA_API_BASE_URL": "https://paper-api.alpaca.markets"
      }
    }
  }
}

利用可能なツール

1. get_account

以下を含む、アカウントの詳細情報を取得します：

• アカウントのステータスと番号
• 購買余力と利用可能な現金
• ポートフォリオの純資産と評価額
• パターンデイトレーダーのステータス
• デイトレード回数
• SMA（特別備忘口座）

2. get_positions

以下の現在の株式ポジションを表示します：

• シンボルと数量
• 現在の時価
• 取得原価と損益
• 未実現損益
• 現在の株価
• ポジションの方向（ロング／ショート）

3. get_quote

任意のシンボルのマーケット価格をリアルタイムで取得します：

• 買値と売値
• 買値と売値の数量
• 価格スプレッドの計算
• 価格のタイムスタンプ

パラメーター：

• symbol（必須）：株式シンボル（例：「AAPL」、「TSLA」、「NVDA」）

4. get_orders

フィルターを指定して最近の注文を一覧表示します：

• 注文 ID とステータス
• シンボルと数量
• 注文タイプと売買区分
• 約定情報
• 注文送信時のタイムスタンプ

パラメーター：

• status（任意）：「open」、「closed」、または「all」（デフォルト：「all」）
• limit（任意）：注文の最大件数（デフォルト：10）

API 認証情報

Alpaca API キーの取得

1. Alpaca Markets でアカウントを登録します
2. ダッシュボードを開き、「API Keys」に移動します
3. ペーパートレード用またはライブトレード用の API キーを新規作成します
4. API Key ID と Secret Key をコピーします

環境の設定

方法 1：環境変数

export APCA_API_KEY_ID="PK..."
export APCA_API_SECRET_KEY="..."
export APCA_API_BASE_URL="https://paper-api.alpaca.markets"

方法 2：.env ファイル

APCA_API_KEY_ID=PK...
APCA_API_SECRET_KEY=...
APCA_API_BASE_URL=https://paper-api.alpaca.markets

安全性とペーパートレード

**⚠️ 重要：**安全のため、このサーバーはデフォルトでペーパートレードモードに設定されています。ペーパートレードでは仮想資金を使用するため、テストや開発に最適です。

ライブトレードに切り替えるには、ベース URL を次のように変更します：

APCA_API_BASE_URL=https://api.alpaca.markets

ライブトレードは、設定に問題がなく、実資金での取引を開始する準備ができている場合にのみご利用ください。

トラブルシューティング

よくある問題

1. 「Missing API credentials」エラー：

   • 環境変数が正しく設定されていることを確認してください
   • 変数名が完全に一致していることを確認してください：APCA_API_KEY_ID、APCA_API_SECRET_KEY

2. 「Connection failed」エラー：

   • API キーが有効であることを確認してください
   • インターネット接続を確認してください
   • ペーパートレード／ライブトレードに適したベース URL を使用していることを確認してください

3. 「Module not found」エラー：

   • 必要な依存関係をインストールしてください：pip install alpaca-trade-api

サーバーのテスト

JSON-RPC を使用して、サーバーを手動でテストできます：

echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/list"}' | python alpaca_mcp_server.py

期待される応答には、利用可能なツールが含まれます。

開発

プロジェクト構成

alpaca-mcp-server/
├── alpaca_mcp_server.py    # Main MCP server
├── README.md               # This documentation
├── requirements.txt        # Python dependencies
└── examples/              # Usage examples

コントリビューション

1. リポジトリをフォークします
2. 機能ブランチを作成します
3. 変更を加えます
4. ペーパートレードで十分にテストします
5. プルリクエストを送信します

ライセンス

MIT ライセンスです。詳細は LICENSE ファイルをご覧ください。

サポート

• 問題の報告：GitHub Issues
• Alpaca API ドキュメント：Alpaca Markets API
• MCP プロトコル：Model Context Protocol

免責事項

このソフトウェアは、教育および開発を目的としています。ライブ取引機能を使用すると、実際のお金で取引することになります。必ず最初にペーパートレードで十分にテストしてください。作者は、いかなる金銭的損失についても責任を負いません。