Utilizes Zod for input validation in the MCP server, ensuring reliable data handling when processing requests and responses.
Mercado Livre - MCP Server
This project is part of the Model Context Protocol (MCP) ecosystem and provides tools for integrating with external sources and managing specific domain models. It is designed to demonstrate how to build an MCP server that scrapes products from Mercado Livre, with strong data validation to ensure reliability.
Table of Contents
- Features
- Architecture
- Installation
- MCP Server Configuration in VSCode
- MCP Server Output in VSCode
- Contribution
- License
Features
- get-produtos: Fetch basic product information.
- Input validation using Zod.
- Integration with the Mercado Livre 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.,Mercado Livre
). - Infrastructure (
src/infrastructure
): Implements external services, such asMercadoLivreApiService
, responsible for making HTTP calls to the Mercado Livre API. - Application (
src/application
): Contains business logic inMercadoLivreService
, which processes and formats data from the infrastructure. - Interface (
src/interface
): Includes controllers (MercadoLivreToolsController
) 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 "products" and then "Start Server"
MCP Server Output in VSCode
- Press
Ctrl+Shift+P
and select "MCP: List Servers" - Select "products" 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
Mercado Livre MCP Server
Related MCP Servers
- Python
- -securityAlicense-qualityMarineTraffic MCP ServerLast updated -4TypeScriptMIT License
- TypeScriptMIT License
- RustMIT License