Alpaca MCP

🚀 Alpaca MCP サーバー

このサーバーは、Alpaca API を通じて暗号通貨市場データへのリアルタイムアクセスを提供するモデルコンテキストプロトコル (MCP) サーバーです。暗号通貨データを取得するための標準インターフェースを実装しています。

✨ 主な機能

• 日次、週次、月次の暗号通貨時系列データ
• 最新の暗号取引所レート
• 過去の棒グラフ/ローソク足データ
• 組み込みのエラー処理とレート制限管理

📦 インストール

Claude Desktop を使用する場合

Docker を通じたインストール

• リポジトリをクローンし、Claude デスクトップクライアント用にローカルイメージをビルドします。

cd alpaca-mcp
docker build -t mcp/alpaca .

• claude_desktop_config.json ファイルを以下の設定に合わせて変更し、REPLACE_API_KEY と REPLACE_API_SECRET を実際のキーに置き換えます。

claude_desktop_config.json のパス

• MacOS の場合：~/Library/Application\ Support/Claude/claude_desktop_config.json
• Windows の場合：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "alpaca": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "-e",
        "ALPACA_API_KEY",
        "-e",
        "ALPACA_API_SECRET",
        "mcp/alpaca"
      ],
      "env": {
        "ALPACA_API_KEY": "REPLACE_API_KEY",
        "ALPACA_API_SECRET": "REPLACE_API_SECRET"
      }
    }
  }
}

UV（高速 Python パッケージインストーラー）を通じたインストール

UV は、インストールプロセスを簡素化できる最新の Python パッケージインストーラーです。UV を使用して alpaca-mcp をインストールするには：

1. まず UV をインストール します（まだ持っていない場合）。

# pip を使用する場合
pip install uv

# macOS で brew を使用する場合
brew install uv

2. Claude Desktop の設定ファイルを UV を使用するように設定します。

{
  "mcpServers": {
    "alpaca": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/alpaca-mcp",
        "run",
        "alpaca-mcp"
      ],
      "env": {
        "ALPACA_API_KEY": "REPLACE_API_KEY",
        "ALPACA_API_SECRET": "REPLACE_API_SECRET"
      }
    }
  }
}

3. UV を使用してパッケージをインストールします。

# リポジトリをクローンする
git clone https://github.com/berlinbra/alpaca-mcp.git
cd alpaca-mcp

# UV を使用して依存関係をインストールする
uv pip install -e .

4. UV を使用してサーバーを起動します。

uv run alpaca_mcp/server.py

5. デバッグ目的で、MCP インスペクターを使用することができます。

npx @modelcontextprotocol/inspector uv --directory /path/to/alpaca-mcp run src/alpaca-mcp/server.py

標準的な開発環境設定

# リポジトリをクローンする
git clone https://github.com/berlinbra/alpaca-mcp.git
cd alpaca-mcp

# 仮想環境を作成してアクティブ化する
python -m venv venv
source venv/bin/activate  # Windows の場合：venv/Scripts/activate

🔧 エラー処理

サーバーには、様々な状況に対応した包括的なエラー処理が組み込まれています。

• レート制限超過
• 無効な API キー
• ネットワーク接続問題
• タイムアウト処理
• 不明瞭な応答

エラーメッセージは、人間が読みやすい形式で返されます。

🔍 前提条件

• Python 3.12 以上
• httpx
• mcp
• alpaca-py
• python-dotenv（環境変数の読み込みに使用）

📄 ライセンス

この MCP サーバーは、MIT License の下でライセンスされています。