Sobre el proyecto

Alpaca MCP Server es un servidor oficial del Protocolo de Contexto de Modelo para las API de Trading y Datos de Mercado de Alpaca. Permite que asistentes e IDE compatibles con MCP —incluidos Claude Desktop, Claude Code, Cursor, VS Code, PyCharm y Antigravity— descubran las herramientas de Alpaca y realicen tareas de trading o investigación mediante solicitudes en lenguaje natural. La versión 2 es una reescritura completa construida con FastMCP y OpenAPI. No es compatible con versiones anteriores a la v1: los nombres de las herramientas, los parámetros, los esquemas y la configuración cambiaron, por lo que las instalaciones actualizadas deben reconfigurarse, reiniciar los clientes e iniciar sesiones nuevas. La v1 puede permanecer fijada a la última versión 1.x si es necesario. El servidor se ejecuta localmente a través de stdio usando uvx, o se puede compilar y ejecutar con Docker. La configuración se proporciona mediante variables de entorno en la configuración del cliente MCP: ALPACA_API_KEY y ALPACA_SECRET_KEY son obligatorias, ALPACA_PAPER_TRADE tiene el valor predeterminado true, y ALPACA_TOOLSETS puede restringir las capacidades expuestas. El README advierte contra exponer el servidor directamente a internet público porque no proporciona por sí mismo autenticación MCP remota. Las capacidades expuestas se organizan en conjuntos de herramientas para información de cuenta y cartera, trading, posiciones, listas de seguimiento, activos y estado del mercado, datos de acciones, datos de criptomonedas, datos de opciones, acciones corporativas, noticias, datos de renta fija y localizaciones de ventas en corto. Las operaciones específicas incluyen ver saldos y poder de compra, recuperar el historial de cartera y las actividades de la cuenta, realizar pedidos de acciones/ETF, criptomonedas y opciones, reemplazar o cancelar pedidos, ver o cerrar posiciones, ejercer opciones y gestionar listas de seguimiento. Las herramientas de datos de mercado cubren barras históricas y más recientes, cotizaciones, operaciones, instantáneas, libros de órdenes, cadenas de opciones, griegas, volatilidad implícita, calendarios, relojes, anuncios de acciones corporativas, noticias y cotizaciones de renta fija. El servidor también incluye herramientas de consulta de documentación para las guías de Alpaca y las referencias de endpoints de OpenAPI. Algunas capacidades de datos y de localización dependen de la suscripción de Alpaca o de la elegibilidad de una cuenta real. El proyecto documenta la configuración para múltiples clientes MCP, la configuración de trading en vivo, el filtrado de conjuntos de herramientas, ejemplos de prompts y una suite de pruebas que contiene comprobaciones de integridad, pruebas de construcción del servidor, pruebas de integración con la API de paper trading y pruebas de integración de documentación.