Status Invest MCP Server

MIT License
1

Integrations

  • Used for input validation in the MCP server, ensuring data sent to the Status Invest API is properly formatted

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

  • 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.

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

MCP Status Invest: Un servidor de Protocolo de Contexto de Modelo (MCP) para interactuar con la API de Status Invest. Proporciona herramientas para obtener datos e indicadores bursátiles, con una arquitectura en capas y validación de datos mediante Zod.

  1. Table of Contents
    1. Features
      1. Architecture
        1. Installation
          1. MCP Server Configuration in VSCode
            1. MCP Server Output in VSCode
              1. Contribution
                1. License

                  Related MCP Servers

                  View all related MCP servers

                  ID: ts8oktksv0