Servidor MCP de Alpaca

Este es un servidor de Protocolo de Contexto de Modelo (MCP) para Alpaca, que permite a LLM como Claude interactuar con la API de trading de Alpaca. Permite operar con acciones, consultar posiciones, obtener datos de mercado y gestionar la cuenta, todo mediante lenguaje natural.

Características

📊 Datos de mercado : obtenga cotizaciones de acciones en tiempo real y datos históricos de precios
💵 Información de la cuenta : consulta tus saldos, poder adquisitivo y estado
📈 Gestión de puestos : vea los puestos actuales y su rendimiento
🛒 Colocación de órdenes : coloque órdenes de mercado y límite a través del lenguaje natural
📋 Gestión de pedidos : enumerar, rastrear y cancelar pedidos

Related MCP server: Alpaca Trading MCP Server

Prerrequisitos

Python 3.10+
Claves API de Alpaca
Claude para escritorio u otro cliente MCP

Instalación

Clonar este repositorio:
git clone https://github.com/YOUR_USERNAME/alpaca-mcp.git cd alpaca-mcp
Instalar los paquetes necesarios:
pip install mcp alpaca-py python-dotenv
Cree un archivo .env con sus credenciales de API de Alpaca:
API_KEY_ID=your_alpaca_api_key API_SECRET_KEY=your_alpaca_secret_key

Uso

Ejecutando el servidor

Inicie el servidor ejecutando:

python alpaca_mcp_server.py

Configuración de Claude para escritorio

Abrir Claude para escritorio
Ir a Configuración
Haga clic en "Desarrollador" y luego en "Editar configuración".
Agregue la configuración del servidor a claude_desktop_config.json :

{ "mcpServers": { "alpaca": { "command": "python", "args": [ "/path/to/alpaca_mcp_server.py" ], "env": { "API_KEY_ID": "your_alpaca_api_key", "API_SECRET_KEY": "your_alpaca_secret_key" } } } }

Guardar y reiniciar Claude para escritorio

Herramientas disponibles

El servidor expone las siguientes herramientas:

get_account_info() - Obtener saldos y estados de cuentas
get_positions() - Lista todas las posiciones actuales en la cartera
get_stock_quote(symbol) - Obtener la última cotización de una acción
get_stock_bars(symbol, days) : obtiene barras de precios históricas de una acción
get_orders(status, limit) - Lista los pedidos con el estado especificado
place_market_order(symbol, side, quantity) - Realizar una orden de mercado
place_limit_order(symbol, side, quantity, limit_price) - Realizar un pedido limitado
cancel_all_orders() - Cancelar todos los pedidos abiertos
close_all_positions(cancel_orders) - Cerrar todas las posiciones abiertas

Consultas de ejemplo

Una vez que el servidor esté conectado a Claude, puedes hacer preguntas como:

"¿Cuál es el saldo de mi cuenta corriente y mi poder adquisitivo?"
"Muéstrame mis posiciones actuales"
Obtenga la cotización más reciente de AAPL
Muéstrame el historial de precios de TSLA de los últimos 10 días.
Compra 5 acciones de MSFT a precio de mercado.
Vender 10 acciones de AMZN con un precio límite de $130.
"Cancelar todos mis pedidos abiertos"

Nota

Este servidor utiliza el trading en papel de Alpaca por defecto. Para operar con dinero real, cambie paper=True a paper=False al inicializar TradingClient .

Aviso de seguridad

Este servidor MCP tendrá acceso a tu cuenta de Alpaca y podrá realizar intercambios reales. Revisa siempre las sugerencias de Claude antes de aprobar cualquier intercambio.