JinDaGe - MercadoLibre MCP Details

article

README

🚀 MercadoLibre MCP 服务器

这是一个提供对 MercadoLibre API 访问权限的 MCP 服务器，借助它可便捷地访问 MercadoLibre 平台上的各类商品信息。

🚀 快速开始

此服务器可助力你访问 MercadoLibre API，获取商品搜索、评论、描述以及卖家信誉等信息。

✨ 主要特性

工具

search_products - 在 MercadoLibre 搜索商品，并返回商品列表。
- query - 搜索查询
- category - 要搜索的商品类别
- filters - 应用的筛选条件
product_reviews - 获取商品评论
product_description - 获取商品描述
seller_reputation - 获取卖家信誉

📦 安装指南

先决条件

使用此服务器需要 MercadoLibre 的客户端 ID 和客户端密钥。您可以在 MercadoLibre 开发者平台创建一个免费应用并获取这些凭证。

获取凭证后，可以通过设置 CLIENT_ID 和 CLIENT_SECRET 环境变量来配置这些信息。此外，还需要设置 SITE_ID 环境变量以指定要使用的站点。

Mercado Libre 站点 ID

| 站点 ID | 国家 | | ---- | ---- | | MLA | 阿根廷（默认） | | MLB | 巴西 | | MCO | 哥伦比亚 | | MEX | 墨西哥 | | MLU | 乌拉圭 | | MLC | 智利 |

安装方法

有多种方式可以使用此服务器：

使用 Smithery 进行安装（推荐）

通过 Smithery 自动安装 MercadoLibre MCP 服务器以供 Claude Desktop 使用：

npx -y @smithery/cli install @lumile/mercadolibre-mcp --client claude

方法一：使用 NPX（推荐）

在您的 Claude Desktop 配置文件中添加以下内容：

{
  "mcpServers": {
    "mercadolibre-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mercadolibre-mcp"
      ],
      "env": {
        "CLIENT_ID": "<YOUR_CLIENT_ID>",
        "CLIENT_SECRET": "<YOUR_CLIENT_SECRET>",
        "SITE_ID": "<YOUR_SITE_ID>"
      }
    }
  }
}

方法二：本地安装

克隆仓库
安装依赖：

npm install

构建服务器：

npm run build

在您的 Claude Desktop 配置文件中添加以下内容：

{
  "mcpServers": {
    "mercadolibre-mcp": {
      "command": "node",
      "args": [
        "/path/to/mercadolibre-mcp/dist/index.js"
      ],
      "env": {
        "CLIENT_ID": "<YOUR_CLIENT_ID>",
        "CLIENT_SECRET": "<YOUR_CLIENT_SECRET>",
        "SITE_ID": "<YOUR_SITE_ID>"
      }
    }
  }
}

📚 详细文档

调试

由于 MCP 服务器通过标准输入输出进行通信，调试可能会比较困难。我们推荐使用 MCP 检查器，这是一个可以通过命令运行的调试工具：

npm run inspector

检查器将提供一个访问调试工具的 URL，您可以在浏览器中打开。

贡献

非常欢迎任何贡献！请通过提交 PR 为新 MCP 服务器或改进代码仓库做出贡献。

免责声明

该项目与 MercadoLibre 。所有徽标均属于其各自的所有者。

📄 许可证

此项目在 MIT 许可证下发布，具体许可证内容请参阅 LICENSE.md 文件。

MercadoLibre