Mercado Livre - MCP Server

一种集成，可让 MCP 工具直接从 Mercado Livre 抓取商品数据，例如价格和库存情况。

目录

• 功能
• 架构
• 安装
• 在 VSCode 中配置 MCP 服务
• 在 VSCode 中查看 MCP 服务输出
• 贡献
• 许可证

功能

• get-produtos：获取商品基本信息。
• 使用 Zod 验证输入。
• 在基础设施层使用 fetch 集成 Mercado Livre API。

架构

本项目采用受领域驱动设计（DDD）模式启发的分层架构：

• 领域（src/domain）： 定义表示数据结构（例如，Mercado Livre）的接口和类型。

• 基础设施（src/infrastructure）： 实现外部服务，例如 MercadoLivreApiService，负责向 Mercado Livre API 发起 HTTP 调用。

• 应用（src/application）： 在 MercadoLivreService 中包含业务逻辑，用于处理和格式化来自基础设施的数据。

• 接口（src/interface）： 包含控制器（MercadoLivreToolsController），用于在 MCP 服务中注册工具、定义验证模式并返回结果。

• 入口点（src/main.ts）： 初始化 McpServer，配置传输方式（StdioServerTransport），实例化服务和控制器，并开始通过 stdio 监听。

文件夹结构如下：

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

安装

git clone [email protected]:newerton/mcp-mercado-livre.git
cd mcp-mercado-livre
npm install
npm run build

在 VSCode 中配置 MCP 服务

1. 按 Ctrl+Shift+P 并选择“MCP: List Servers”
2. 选择“products”，然后选择“Start Server”

在 VSCode 中查看 MCP 服务输出

1. 按 Ctrl+Shift+P 并选择“MCP: List Servers”
2. 选择“products”，然后选择“Show Output”

贡献

欢迎提交拉取请求！欢迎随时提出问题并讨论改进方案。

许可证

本项目采用 MIT 许可证授权，详情请参阅 LICENSE 文件。