Alpaca MCP Server

Exposa les dades de mercat d'Alpaca i l'API de broker com a eines MCP.

Instal·lació

Instal·lació via Smithery

Per instal·lar el servidor de dades de mercat d'Alpaca per a Claude Desktop automàticament via Smithery:

npx -y @smithery/cli install @cesarvarela/alpaca-mcp --client claude

Instal·lació manual

npm install alpaca-mcp

Desenvolupament local

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

Variables d'entorn

Crea un .env a la arrel del projecte amb:

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

Comandes

• start (dev): npm start (executa npx tsx index.ts)
• build: npm run build (compila a dist/)
• run compiled: node dist/index.js

Ús

Un cop en execució, el servidor MCP escolta a stdin/stdout. Utilitza qualsevol client MCP o la CLI:

npm link      # opcional
alpaca-mcp    # inicia el servidor globalment

Eines disponibles

• get-assets{ 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[] }

Cada una retorna JSON a content[0].text o un error.

Configuració del client MCP

Per integrar via mcp.config.json, afegeix el següent sota la clau 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>"
      }
    }
  }
}

Publicació

npm publish

Licència

ISC