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

Related MCP server: Alpaca MCP Server

Instalación

1. Clonar este repositorio

2. Instalar dependencias:

pip install -e .

O usando uv:

uv pip install -e .

Configuración

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

cp .env.example .env

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

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

Puede obtener estas credenciales creando una cuenta en Alpaca .

Uso

Ejecute el servidor MCP:

python src/server.py

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