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

Prerrequisitos

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

Instalación

1. Clonar este repositorio:
   git clone https://github.com/YOUR_USERNAME/alpaca-mcp.git cd alpaca-mcp
2. Instalar los paquetes necesarios:
   pip install mcp alpaca-py python-dotenv
3. 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:

Configuración de Claude para escritorio

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

5. 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.

Licencia

Instituto Tecnológico de Massachusetts (MIT)