Demo Mercadopago MCP Server

🚀 Mercado Pago MCP サーバーデモ

このサーバーは、モデルコンテキストプロトコル（Model Context Protocol）を使用し、Mercado Pago をアプリケーションに統合するためのツールを提供します。

🚀 クイックスタート

このセクションでは、Mercado Pago MCP サーバーのセットアップと使用方法を説明します。

📦 インストール

1. リポジトリのクローン

git clone https://github.com/mercadolibre/demo-mercadopago-mcp-server.git
cd demo-mercadopago-mcp-server

2. 依存関係のインストール

npm install

3. Mercado Pago API 認証情報の取得

有効な Mercado Pago API 認証情報を環境変数で提供する必要があります。

• Mercado Pago 開発者コントロールパネル から認証情報を取得します。
• CLIENT_ID：あなたの Mercado Pago アプリケーション ID
• CLIENT_SECRET：あなたの Mercado Pago シークレットキー

4. IDE での MCP サーバーの設定

Claude Desktop やその他の MCP 対応アプリケーション（Windsurf、Cursor、Cline など）と一緒に使用するには、サーバー設定を追加します。

{
  "mcpServers": {
    "mercadopago": {
      "command": "node",
      "args": ["/path/to/demo-mercadopago-mcp-server/build/index.js"],
      "env": {
        "CLIENT_ID": "あなたの-mercadopago-client-id",
        "CLIENT_SECRET": "あなたの-mercadopago-client-secret",
        "DEBUG": "true"  // オプション：デバッグログを有効にする
      }
    }
  }
}

✨ 主な機能

search_documentation

Mercado Pago のドキュメントを検索します。

パラメータ

• language (string, 必須)

  • ドキュメントの言語
  • オプション："es"（スペイン語）、"pt"（ポルトガル語）

• query (string, 必須)

  • ドキュメント内で検索する用語

• siteId (string, 必須)

  • 国のサイト識別子
  • オプション："MLB"（ブラジル）、"MLA"（アルゼンチン）、"MLM"（メキシコ）、"MLU"（ウルグアイ）、"MLC"（チリ）、"MCO"（コロンビア）、"MPE"（ペルー）

• limit (number, オプション)

  • 返される最大結果数
  • デフォルト値：10
  • 範囲：1 - 100

リクエスト例

<use_mcp_tool>
<server_name>mercadopago</server_name>
<tool_name>search_documentation</tool_name>
<arguments>
{
  "language": "es",
  "query": "checkout pro",
  "siteId": "MLA",
  "limit": 3
}
</arguments>
</use_mcp_tool>

レスポンス例

# 「checkout pro」の検索結果
8 件中 3 件の結果を表示

## Checkout Pro
Checkout Pro は、あなたの顧客が安全に支払いを行うことができるソリューションです...

🔗 [詳細を見る](https://www.mercadopago.com.ar/developers/es/guides/checkout-pro/introduction)

スコア：0.95

---

## Checkout Pro の統合
Checkout Pro をあなたのウェブサイトに統合して支払いを受け取り始める方法を学びます...

🔗 [詳細を見る](https://www.mercadopago.com.ar/developers/es/guides/checkout-pro/integration)

スコア：0.85

📚 ドキュメント

開発ガイド

ビルド

依存関係のインストール：

npm install

サーバーのビルド：

npm run build

開発モードでの変更監視：

npm run watch

実行

サーバーを実行するための環境変数を設定し、デバッグ情報を追加します。

DEBUG=true npm start

デバッグ情報

• 状態：mercadopago:*
• 内部使用のみ：mercadopago:internal

リクエストとレスポンスの例

リクエスト例

POST / HTTP/1.1
Content-Type: application/json

{
    "language": "es",
    "query": "checkout pro",
    "siteId": "MLA",
    "limit": 3
}

レスポンス例

{
    "results": [
        {
            "title": "Checkout Pro ガイド",
            "url": "https://www.mercadopago.com.ar/developers/es/guides/checkout-pro/introduction",
            "score": 0.95
        },
        {
            "title": "Checkout Pro の統合",
            "url": "https://www.mercadopago.com.ar/developers/es/guides/checkout-pro/integration",
            "score": 0.85
        }
    ]
}