HelloWorld
登录
n

newerton

web-scrapingecommerce-and-retail

315 查看 · 2026-07-07 更新

Mercado Livre - MCP 服务器

该项目是 Model Context Protocol (MCP) 生态系统的一部分，提供了与外部数据源集成并管理特定领域模型的工具。它旨在展示如何构建一个从 Mercado Livre 抓取产品的 MCP 服务器，并通过强大的数据验证来确保可靠性。

该集成使 MCP 工具能够直接从 Mercado Livre 抓取产品数据，如价格和库存情况。 Mercado Livre - MCP Server

目录

特性

  • 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/ # 领域接口 ├── infrastructure/ │ └── services/ # 外部 API 实现 (Mercado Livre) ├── application/ │ └── services/ # 业务逻辑和数据格式化 ├── interface/ │ └── controllers/ # MCP 工具注册和验证 └── main.ts # 服务器入口点 build/ # 编译后的 JavaScript 代码 .vscode/ # 包含 mcp.json 文件，MCP 服务器配置

安装

bash git clone git@github.com: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"

贡献

欢迎提交 Pull 请求！请随时提出问题并讨论改进。

许可证

该项目根据 MIT 许可证发布 - 详情请参阅 LICENSE 文件。

来源