Status Invest MCP Server

Estado de inversión - Servidor MCP

Este proyecto forma parte del ecosistema del Protocolo de Contexto de Modelo (MCP) y proporciona herramientas para interactuar con API externas y gestionar modelos de dominio específicos. Está diseñado para demostrar cómo construir un servidor MCP con integración de API externas y validación de datos.

Tabla de contenido

• Características
• Arquitectura
• Instalación
• Configuración del servidor MCP en VSCode
• Salida del servidor MCP en VSCode
• Contribución
• Licencia

Características

• get-acoes : obtiene información básica sobre acciones.
• get-indicadores : obtiene información detallada del indicador de acciones.
• get-acoes-datas-pagamento : Obtener fechas de pago de acciones.
• Validación de entrada utilizando Zod .
• Integración con la API de Status Invest mediante fetch (capa de infraestructura).

Arquitectura

El proyecto sigue una arquitectura en capas inspirada en patrones de diseño impulsado por el dominio (DDD):

• Dominio ( src/domain ): define interfaces y tipos que representan estructuras de datos (por ejemplo, StatusInvest ).
• Infraestructura ( src/infrastructure ): implementa servicios externos, como StatusInvestApiService , responsable de realizar llamadas HTTP a la API de Status Invest.
• Aplicación ( src/application ): contiene la lógica empresarial en StatusInvestService , que procesa y formatea los datos de la infraestructura.
• Interfaz ( src/interface ): incluye controladores ( StatusInvestToolsController ) que registran herramientas en el servidor MCP, definen esquemas de validación y devuelven resultados.
• Punto de entrada ( src/main.ts ): inicializa McpServer , configura el transporte ( StdioServerTransport ), instancia servicios y controladores, y comienza a escuchar en stdio .

La estructura de carpetas es la siguiente:

Instalación

Configuración del servidor MCP en VSCode

1. Presione Ctrl+Shift+P y seleccione "MCP: Listar servidores"
2. Seleccione “stocks” y luego “Iniciar servidor”

Salida del servidor MCP en VSCode

1. Presione Ctrl+Shift+P y seleccione "MCP: Listar servidores"
2. Seleccione “stocks” y luego “Mostrar salida”

Contribución

¡Las solicitudes de incorporación de cambios son bienvenidas! No dudes en abrir problemas y debatir mejoras.

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo LICENCIA para obtener más detalles.