Alpaca MCP Server

Alpaca MCP サーバー

Alpaca APIを通じて、暗号資産市場データにリアルタイムでアクセスできるModel Context Protocol（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 がまだインストールされていない場合は、まずUV をインストールします。

# Using pip
pip install uv

# Using brew on macOS
brew install uv

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

{
  "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 でパッケージをインストールします。

# Clone the repository
git clone https://github.com/berlinbra/alpaca-mcp.git
cd alpaca-mcp

# Install dependencies using 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

標準的な開発環境のセットアップ

# Clone the repository
git clone https://github.com/berlinbra/alpaca-mcp.git
cd alpaca-mcp

# Create and activate a virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install the package in development mode
pip install -e .

利用可能なツール

現在、サーバーには次のツールが実装されています。

• get-crypto-bars：暗号資産の過去のバー／ローソク足データを取得します

今後、さらにツールを追加する予定です。

get-crypto-bars

入力スキーマ：

{
    "symbol": {
        "type": "string",
        "description": "Cryptocurrency symbol (e.g., BTC/USD, ETH/USD)"
    },
    "timeframe": {
        "type": "string",
        "description": "Timeframe for bars (e.g., 1Day, 1Hour, 1Min)",
        "default": "1Day"
    },
    "start": {
        "type": "string",
        "description": "Start date in YYYY-MM-DD format"
    },
    "limit": {
        "type": "integer",
        "description": "Maximum number of bars to return",
        "default": 10
    }
}

応答例：

Cryptocurrency bars for BTC/USD (1Day):

Date: 2025-04-10
Open: $68750.12
High: $69200.45
Low: $67900.78
Close: $68900.32
Volume: 12345.67
---
Date: 2025-04-11
Open: $68900.32
High: $70100.55
Low: $68400.21
Close: $69800.44
Volume: 15678.90

エラー処理

このサーバーには、さまざまな状況に対応する包括的なエラー処理が含まれています。

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

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

前提条件

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

ライセンス

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