This server enables querying stock market data via the Investidor10 API. You can:
- Fetch basic stock information using the
get-acoes
tool by providing an array of stock symbols - Query multiple stocks simultaneously by passing an array of symbols
- Validate inputs through Zod and JSON schema validation
- Integrate with Investidor10 API to retrieve stock market data
- Use with MCP tools for configuration and management within VSCode
Provides input validation for MCP tools, ensuring data integrity when interacting with the Investidor10 API for stock market data.
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
- Architecture
- Installation
- MCP Server Configuration in VSCode
- MCP Server Output in VSCode
- Contribution
- License
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 asInvestidor10ApiService
, responsible for making HTTP calls to the Investidor10 API. - Application (
src/application
): Contains business logic inInvestidor10Service
, 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 theMcpServer
, configures the transport (StdioServerTransport
), instantiates services and controllers, and starts listening on stdio.
The folder structure is as follows:
Installation
MCP Server Configuration in VSCode
- Press
Ctrl+Shift+P
and select "MCP: List Servers" - Select "stocks" and then "Start Server"
MCP Server Output in VSCode
- Press
Ctrl+Shift+P
and select "MCP: List Servers" - 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.
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.
Tools
Investidor10 MCP Server: A Model Context Protocol (MCP) server for interacting with the Status Invest API. Provides tools for fetching stock data and indicators, with a layered architecture and data validation using Zod
Related MCP Servers
- -securityAlicense-qualityThe MCP Trader Server conducts comprehensive technical analysis on stocks, offering insights into trends, momentum indicators, volatility metrics, and volume analysis to support stock trading decisions.Last updated -175PythonMIT License
- AsecurityAlicenseAqualityA Model Context Protocol (MCP) server that provides comprehensive cryptocurrency analysis using the CoinCap API. This server offers real-time price data, market analysis, and historical trends through an easy-to-use interface.Last updated -356730TypeScriptMIT License
- AsecurityAlicenseAqualityMCP server that provides AI assistants access to stock market data including financial statements, stock prices, and market news through a Model Context Protocol interface.Last updated -11433PythonMIT License
- AsecurityFlicenseAqualityA Model Control Protocol (MCP) server that provides cryptocurrency trading interfaces for Binance exchange, enabling functions like real-time price fetching, account balance queries, order placement/cancellation, and automated arbitrage strategies.Last updated -93Python