Demo Mercado Pago MCP Server

Demo Mercado Pago MCP 服务

一个 Model Context Protocol 服务，提供用于将 Mercado Pago 集成到应用程序中的工具。

安装与设置

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"  // 可选：启用调试日志
         }
       }
     }
   }
   

可用工具

search_documentation

搜索 Mercado Pago 文档。

参数

• language（字符串，必填）

  • 文档语言
  • 选项："es"（西班牙语）、"pt"（葡萄牙语）

• query（字符串，必填）

  • 要在文档中查找的搜索词

• siteId（字符串，必填）

  • 国家/地区站点标识符
  • 选项："MLB"（巴西）、"MLA"（阿根廷）、"MLM"（墨西哥）、"MLU"（乌拉圭）、"MLC"（智利）、"MCO"（哥伦比亚）、"MPE"（秘鲁）

• limit（数字，可选）

  • 返回结果的最大数量
  • 默认值：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