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

Related MCP server: Zerodha Trading MCP

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

Instalación

git clone git@github.com:newerton/mcp-status-invest.git
cd mcp-status-invest
npm install
npm run build

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.