アルパカ MCP サーバー

Alpaca マーケットデータとブローカー API を MCP ツールとして公開します。

インストール

npm install alpaca-mcp

地域開発

git clone <repo-url>
cd alpaca-mcp
npm install

環境変数

プロジェクトのルートに次の.envを作成します。

ALPACA_ENDPOINT=https://data.alpaca.markets
ALPACA_BROKER_ENDPOINT=https://broker-api.alpaca.markets
ALPACA_API_KEY=YOUR_ALPACA_API_KEY
ALPACA_SECRET_KEY=YOUR_ALPACA_SECRET_KEY

コマンド

開始(dev): npm start ( npx tsx index.ts実行)
ビルド: npm run build ( dist/にコンパイルされます)
コンパイルして実行: node dist/index.js

使用法

MCPサーバーは起動するとstdin/stdoutをリッスンします。任意のMCPクライアントまたはCLIを使用してください。

npm link      # optional
alpaca-mcp    # starts server globally

利用可能なツール

資産を取得する{ assetClass?: "us_equity" | "crypto" }
get-stock-bars { symbols: string[]; start: string; end: string; timeframe: string }
get-market-days { start: string; end: string }
get-news { start: string; end: string; symbols: string[] }

それぞれcontent[0].textでJSONを返すかエラーを返します。

MCP クライアント構成

mcp.config.json経由で統合するには、 mcpServersキーの下に以下を追加します。

{
  "mcpServers": {
    "alpaca-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "alpaca-mcp"
      ],
      "env": {
        "ALPACA_ENDPOINT": "https://data.alpaca.markets",
        "ALPACA_BROKER_ENDPOINT": "https://broker-api.alpaca.markets",
        "ALPACA_API_KEY": "<YOUR_API_KEY>",
        "ALPACA_SECRET_KEY": "<YOUR_SECRET_KEY>"
      }
    }
  }
}

## Publishing

```bash
npm publish

ライセンス

ISC