Alpaca Trading

Alpaca Trading MCP Server

Un servidor de Model Context Protocol (MCP) que proporciona una interfaz con la API de trading de Alpaca, permitiéndote gestionar tu cartera de acciones y criptomonedas, realizar operaciones y acceder a datos de mercado.

Características

• Gestión de Cuenta: Ver detalles de la cuenta, saldos y estado de la cartera
• Trading: Realizar órdenes de mercado, limitadas, stop y stop-limit
• Gestión de Cartera: Ver posiciones, calcular rendimiento y cerrar posiciones
• Datos de Mercado: Acceder a cotizaciones en tiempo real y datos históricos de precios
• Información de Activos: Obtener detalles sobre activos negociables

Instalación

Instalación mediante Smithery

Para instalar Alpaca Trading MCP Server para Claude Desktop automáticamente mediante Smithery:

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

Instalación Manual

1. Clona este repositorio
2. Instala las dependencias:

pip install -e .

O usando uv:

uv pip install -e .

Configuración

1. Copia el archivo .env.example a .env:

cp .env.example .env

2. Añade tus credenciales de la API de Alpaca Paper Trading al archivo .env:

ALPACA_PAPER_API_KEY = "your-api-key"
ALPACA_PAPER_API_SECRET = "your-api-secret"

Puedes obtener estas credenciales creando una cuenta en Alpaca.

Uso

Ejecuta el servidor MCP:

python src/server.py

El servidor se iniciará y estará disponible para que los clientes MCP se conecten.

Pruebas con Claude for Desktop

Configuración:

Abre la configuración de tu aplicación Claude for Desktop en un editor de texto. Crea el archivo si no existe.

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Mac: ~/Library/Application\ Support/Claude/claude_desktop_config.json

Añade la configuración del servidor MCP de Alpaca:

{
    "mcpServers": {
        "alpaca": {
            "command": "uv",
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/PARENT/FOLDER/alpaca-mcp-server",
                "run",
                "src/server.py"
            ]
        }
    }
}

MCP For Server Developers: Quickstart

Recursos Disponibles

El servidor proporciona los siguientes recursos:

• account://info - Obtener información actual de la cuenta
• positions://all - Obtener todas las posiciones actuales
• positions://{symbol} - Obtener detalles de posición para un símbolo específico
• orders://recent/{limit} - Obtener las órdenes más recientes con un límite especificado
• market://{symbol}/quote - Obtener la cotización de mercado actual para un símbolo específico
• market://{symbol}/bars/{timeframe} - Obtener barras de precios históricas para un símbolo con un marco temporal especificado
• assets://list - Listar activos negociables disponibles en Alpaca
• assets://{symbol} - Obtener información detallada del activo por símbolo

Herramientas Disponibles

El servidor proporciona las siguientes herramientas:

• get_account_info_tool - Obtener información actual de la cuenta
• place_market_order - Realizar una orden de mercado para comprar o vender una acción
• place_limit_order - Realizar una orden limitada para comprar o vender una acción a un precio especificado
• place_stop_order - Realizar una orden stop para comprar o vender una acción cuando alcance un precio especificado
• place_stop_limit_order - Realizar una orden stop-limit que combina las características de las órdenes stop y limitadas
• cancel_order - Cancelar una orden abierta por su ID
• close_position - Cerrar una posición abierta para un símbolo específico
• get_portfolio_summary - Obtener un resumen completo de la cartera