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

• 📚 Documentación de Alpaca : acceda a la documentación del SDK de Alpaca para compilar

• 📊 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: Schwab Model Context Protocol Server

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:

python alpaca_mcp_server.py

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 :

{
  "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"
      }
    }
  }
}

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)