Demo Mercado Pago MCP Server

Demo Mercado Pago MCP サーバー

Mercado Pago をアプリケーションに統合するためのツールを提供する Model Context Protocol サーバーです。

インストールとセットアップ

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 Developer Dashboard から認証情報を取得します
   • 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": "your-mercadopago-client-id",
           "CLIENT_SECRET": "your-mercadopago-client-secret",
           "DEBUG": "true"  // Optional: Enable debug logging
         }
       }
     }
   }
   

利用可能なツール

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>

レスポンス例：

# Search Results for "checkout pro"
Showing 3 of 8 results

## Checkout Pro
Checkout Pro es una solución que permite a tus clientes realizar pagos de forma segura...

🔗 [Read more](https://www.mercadopago.com.ar/developers/es/guides/checkout-pro/introduction)

Score: 0.95

---

## Integrar Checkout Pro
Aprende a integrar Checkout Pro en tu sitio web para comenzar a recibir pagos...

🔗 [Read more](https://www.mercadopago.com.ar/developers/es/guides/checkout-pro/integration)

Score: 0.85

開発ガイド

ビルド

依存関係をインストールします：

npm install

サーバーをビルドします：

npm run build

開発用のウォッチモード：

npm run watch

実行

環境変数を設定します：

export CLIENT_ID=your_mercadopago_client_id
export CLIENT_SECRET=your_mercadopago_client_secret
export DEBUG=true  # Optional: Enable debug logging

サーバーを起動します：

npm start

テスト用にインスペクターを使用して実行します：

npm run inspector