Servidor MCP de Alpaca Trading

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona una interfaz a la API de comercio de Alpaca, permitiéndole administrar su cartera de acciones y criptomonedas, realizar operaciones y acceder a datos del mercado.

Características

• Administración de cuentas : vea los detalles de la cuenta, los saldos y el estado de la cartera
• Trading : Colocar órdenes de mercado, límite, stop y stop-limit
• Gestión de cartera : ver posiciones, calcular el rendimiento y cerrar posiciones
• Datos de mercado : acceda a cotizaciones en tiempo real y datos históricos de precios
• Información sobre activos : obtenga detalles sobre los activos negociables

Instalación

1. Clonar este repositorio
2. Instalar dependencias:

O usando uv:

Configuración

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

2. Agregue sus credenciales de API de Alpaca Paper Trading al archivo .env :

Puede obtener estas credenciales creando una cuenta en Alpaca .

Uso

Ejecute el servidor MCP:

El servidor se iniciará y estará disponible para que los clientes de MCP puedan conectarse.

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 la posición de un símbolo específico
• orders://recent/{limit} - Obtener los pedidos más recientes con el límite especificado
• market://{symbol}/quote - Obtener la cotización actual del mercado para un símbolo específico
• market://{symbol}/bars/{timeframe} - Obtener barras de precios históricas para un símbolo con un período de tiempo específico
• assets://list - Lista de activos negociables disponibles en Alpaca
• assets://{symbol} - Obtenga información detallada de los activos 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 - Colocar una orden de mercado para comprar o vender una acción
• place_limit_order - Coloque una orden limitada para comprar o vender una acción a un precio específico
• place_stop_order - Coloca una orden de stop para comprar o vender una acción cuando alcanza un precio específico
• place_stop_limit_order - Coloque una orden stop-limit combinando funciones de órdenes stop y limit
• 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 - Obtenga un resumen completo de la cartera