hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

Used for loading Alpaca API credentials from environment variables to securely connect to the Alpaca trading platform.
Required for cloning the repository as part of the installation process.
Source for cloning the repository containing the MCP server code.

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

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.

Licencia

Instituto Tecnológico de Massachusetts (MIT)

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

Un servidor de protocolo de contexto de modelo que permite a los LLM como Claude interactuar con la API de comercio de Alpaca, lo que permite negociar acciones, verificar posiciones, obtener datos de mercado y administrar cuentas a través del lenguaje natural.

Alpaca MCP Server