convez.ai
MCP ServerFinanceiroIntermediário
newerton

Investidor10 MCP Server

newerton/mcp-investidor10

Integração com Investidor10 para dados de ações e indicadores

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que integra a API Status Invest para consulta de dados de ações e indicadores do mercado de bolsa. Implementa arquitetura em camadas com validação de dados via Zod, permitindo que Claude acesse informações de cotações e análises técnicas em tempo real.

Instalação

$npx convez-ai newerton/mcp-investidor10

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
5
Forks
3
Acompanhando
1
Saúde
42%
Último commit
há 3 dias
Versão
1.0.0
Issues abertas
0
Contribuidores
2

Casos de uso

  • Consultar preços e cotações de ações brasileiras
  • Analisar indicadores técnicos de empresas listadas
  • Construir dashboards de investimentos com dados em tempo real

Veredito

MCP server bem estruturado com arquitetura em camadas (DDD) que facilita integração com a API Investidor10. Ideal para quem precisa de dados de mercado de bolsa brasileira em aplicações Claude, com validação robusta de inputs.

README

A tradução para o português deste README ainda está na fila.

Investidor10 - MCP Server

This project is part of the Model Context Protocol (MCP) ecosystem and provides tools to interact with external APIs and manage specific domain models. It is designed to demonstrate how to build an MCP server with external API integration and data validation.

Table of Contents

Features

  • get-acoes: Fetch basic stock information.
  • Input validation using Zod.
  • Integration with the Investidor10 API using fetch (infrastructure layer).

Architecture

The project follows a layered architecture inspired by Domain-Driven Design (DDD) patterns:

  • Domain (src/domain): Defines interfaces and types that represent data structures (e.g., Investidor10).

  • Infrastructure (src/infrastructure): Implements external services, such as Investidor10ApiService, responsible for making HTTP calls to the Investidor10 API.

  • Application (src/application): Contains business logic in Investidor10Service, which processes and formats data from the infrastructure.

  • Interface (src/interface): Includes controllers (Investidor10ToolsController) that register tools in the MCP server, define validation schemas, and return results.

  • Entry Point (src/main.ts): Initializes the McpServer, configures the transport (StdioServerTransport), instantiates services and controllers, and starts listening on stdio.

The folder structure is as follows:

src/
├── domain/
│   └── models/           # Domain interfaces
├── infrastructure/
│   └── services/         # External API implementations (Investidor10)
├── 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

Installation

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

MCP Server Configuration in VSCode

  1. Press Ctrl+Shift+P and select "MCP: List Servers"
  2. Select "stocks" and then "Start Server"

MCP Server Output in VSCode

  1. Press Ctrl+Shift+P and select "MCP: List Servers"
  2. Select "stocks" and then "Show Output"

Contribution

Pull requests are welcome! Feel free to open issues and discuss improvements.

License

This project is licensed under the MIT license - see the LICENSE file for details.

Ver o original no GitHub

Bom para

Relacionados