Mercadolibre

🚀 MercadoLibre MCP サーバー

MercadoLibre API へのアクセス権を提供する MCP サーバーです。

🚀 クイックスタート

このサーバーを使用することで、MercadoLibre API へのアクセスが可能になります。以下に、機能やインストール方法などを詳しく説明します。

✨ 主な機能

ツール

• search_products - MercadoLibre で商品を検索し、商品リストを返します。
  • query - 検索クエリ
  • category - 検索対象の商品カテゴリ
  • filters - 適用するフィルタ条件
• product_reviews - 商品レビューを取得します。
• product_description - 商品の説明を取得します。
• seller_reputation - 売り手の評判を取得します。

📦 インストール

前提条件

このサーバーを使用するには、MercadoLibre のクライアント ID とクライアントシークレットが必要です。https://developers.mercadolibre.com/ で無料のアプリを作成し、これらの認証情報を取得できます。

認証情報を取得したら、CLIENT_ID と CLIENT_SECRET 環境変数を設定することでこれらの情報を構成できます。さらに、使用するサイトを指定するために SITE_ID 環境変数も設定する必要があります。

Mercado Libre サイト ID

• MLA: アルゼンチン（デフォルト）
• MLB: ブラジル
• MCO: コロンビア
• MEX: メキシコ
• MLU: ウルグアイ
• MLC: チリ

インストール方法

このサーバーを使用する方法はいくつかあります。

Smithery を使用したインストール（推奨）

Smithery を通じて、Claude Desktop で使用するための MercadoLibre MCP サーバーを自動的にインストールします。

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>"
      }
    }
  }
}

方法二：ローカルインストール

1. リポジトリをクローンします。
2. 依存関係をインストールします。

npm install

3. サーバーをビルドします。

npm run build

4. 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 を提供し、ブラウザで開くことができます。

🤝 コントリビューション

どんなコントリビューションも大歓迎です！新しい MCP サーバーやコードリポジトリの改善のために PR を提出してください。

⚠️ 免責事項

このプロジェクトは MercadoLibre とは関係ありません。すべてのロゴはそれぞれの所有者に帰属します。

📄 ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。詳細なライセンス内容は LICENSE.md ファイルを参照してください。