使用说明

项目简介

MercadoLibre MCP Server 是一个基于 Model Context Protocol (MCP) 构建的应用后端，旨在为大语言模型（LLM）客户端提供访问 MercadoLibre (美客多) 电商平台数据的能力。通过集成此 MCP 服务器，LLM 应用可以调用预设的工具，例如搜索商品、查询商品评价、获取商品描述以及评估卖家信誉，从而实现电商相关的功能扩展。

主要功能点

商品搜索 (search_products): 允许用户通过关键词在 MercadoLibre 平台上搜索商品，并返回商品列表。支持关键词、搜索数量限制和结果偏移量等参数。
商品评价查询 (product_reviews): 获取指定商品的买家评价信息。
商品描述获取 (product_description): 获取指定商品的详细描述信息。
卖家信誉查询 (seller_reputation): 查询指定卖家的信誉等级和相关信息。

安装步骤

本MCP服务器可以通过 Smithery 或手动安装两种方式部署。

方式一：通过 Smithery 安装 (推荐 Claude Desktop 用户)

如果您使用 Claude Desktop，可以通过 Smithery 快速安装：

确保已安装 Smithery CLI。

运行以下命令，一键安装 MercadoLibre MCP Server：

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

方式二：手动安装

克隆仓库:

git clone https://github.com/lumile/mercadolibre-mcp.git
cd mercadolibre-mcp

安装依赖:
```
npm install
```
构建项目:
```
npm run build
```

服务器配置

要使用 MercadoLibre MCP Server，您需要配置 MercadoLibre API 的凭据以及站点 ID。

获取 MercadoLibre API 凭据:
- 访问 MercadoLibre 开发者平台，创建一个应用并获取 Client ID 和 Client Secret。
设置环境变量:
- 您需要设置以下环境变量：
  - 'CLIENT_ID': 您的 MercadoLibre Client ID
  - 'CLIENT_SECRET': 您的 MercadoLibre Client Secret
  - 'SITE_ID': 您要访问的 MercadoLibre 站点 ID。常用的站点 ID 包括：
    - 'MLA': 阿根廷 (默认)
    - 'MLB': 巴西
    - 'MCO': 哥伦比亚
    - 'MEX': 墨西哥
    - 'MLU': 乌拉圭
    - 'MLC': 智利
您可以通过多种方式设置环境变量，例如在 '.env' 文件中配置（项目根目录下创建 '.env' 文件，并添加 'CLIENT_ID=your_client_id', 'CLIENT_SECRET=your_client_secret', 'SITE_ID=MLA' ），或者直接在运行环境中设置。

MCP 客户端配置 (以 Claude Desktop 为例):

在 Claude Desktop 的配置文件中，添加以下 'mcpServers' 配置。

如果使用 NPX 方式运行 (推荐):

{
  "mcpServers": {
    "mercadolibre-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mercadolibre-mcp"
      ],
      "env": {
        "CLIENT_ID": "<YOUR_CLIENT_ID>", // 替换为您的 Client ID
        "CLIENT_SECRET": "<YOUR_CLIENT_SECRET>", // 替换为您的 Client Secret
        "SITE_ID": "<YOUR_SITE_ID>" // 替换为您要使用的站点 ID，例如 MLA, MLB, MEX
      }
    }
  }
}

如果使用本地安装方式运行:

{
  "mcpServers": {
    "mercadolibre-mcp": {
      "command": "node",
      "args": [
        "/path/to/mercadolibre-mcp/dist/index.js" // 替换为您的项目路径
      ],
      "env": {
        "CLIENT_ID": "<YOUR_CLIENT_ID>", // 替换为您的 Client ID
        "CLIENT_SECRET": "<YOUR_CLIENT_SECRET>", // 替换为您的 Client Secret
        "SITE_ID": "<YOUR_SITE_ID>"  // 替换为您要使用的站点 ID，例如 MLA, MLB, MEX
      }
    }
  }
}

注意: 请将 '<YOUR_CLIENT_ID>'、'<YOUR_CLIENT_SECRET>' 和 '<YOUR_SITE_ID>' 替换为您的实际值，并将 '/path/to/mercadolibre-mcp' 替换为您的本地项目路径（如果选择本地安装）。

基本使用方法

启动 MCP 服务器（如果您使用 Claude Desktop，配置完成后会自动启动）。
在支持 MCP 协议的 LLM 客户端中，配置并连接到 'mercadolibre-mcp' 服务器。
在 LLM 中，您可以使用自然语言指令来调用服务器提供的工具，例如：
- '搜索商品 "iPhone 13" ' (调用 'search_products' 工具)
- '查询商品评价商品ID: MLB123456' (调用 'product_reviews' 工具)
- '获取商品描述商品ID: MLA987654' (调用 'product_description' 工具)
- '查询卖家信誉卖家ID: 123456789' (调用 'seller_reputation' 工具)
具体的指令格式可能因 LLM 客户端而异，请参考您使用的 LLM 客户端的文档。

通过 MercadoLibre MCP Server，您的 LLM 应用可以便捷地访问 MercadoLibre 的电商数据，实现更丰富的电商应用场景。

关键词