Estado de inversión - Servidor MCP

Name: Status Invest MCP Server
Author: newerton

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

Related MCP server: mcp-coincap-jj

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:

src/ ├── domain/ │ └── models/ # Domain interfaces ├── infrastructure/ │ └── services/ # External API implementations (Status Invest) ├── application/ │ └── services/ # Business logic and data formatting ├── interface/ │ └── controllers/ # MCP tool registration and validation └── main.ts # Server entry point build/ # Compiled JavaScript code .vscode/ # Contains the mcp.json file, MCP Server config