Servidor MCP Alpaca

Exponga Alpaca Market Data & Broker API como herramientas MCP.

Instalación

Instalación a través de Smithery

Para instalar Alpaca Market Data Server para Claude Desktop automáticamente vía Smithery:

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

Instalación manual

npm install alpaca-mcp

Desarrollo local

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

Variables de entorno

Crear un .env en la raíz del proyecto con

ALPACA_ENDPOINT=https://data.alpaca.markets ALPACA_BROKER_ENDPOINT=https://broker-api.alpaca.markets ALPACA_API_KEY=TU_CLAVE_ALPACA_API_KEY ALPACA_SECRET_KEY=TU_CLAVE_ALPACA_SECRET_KEY

Comandos

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

Uso

Una vez ejecutado, el servidor MCP escucha en stdin/stdout. Utiliza cualquier cliente MCP o la CLI:

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

Herramientas disponibles

• get-assets{ assetClass?: "us_equity" | "crypto" }
• get-stock-bars{ symbols: string[]; start: string; end: string; timeframe: string }
• get-market-days{ inicio: cadena; fin: cadena }
• get-news{ inicio: cadena; fin: cadena; símbolos: cadena[] }

Cada una devuelve JSON en content[0].text o un error.

Configuración del cliente MCP

Para integrar a través de mcp.config.json, añada lo siguiente bajo la clave 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": "<SU_CLAVE_API>", "ALPACA_SECRET_KEY": "<YOUR_SECRET_KEY>" } } } } ## Publishing ```bash npm publish

Licencia

ISC