Back to MCP directory
publicPublicdnsLocal runtime

demo-mercadopago-mcp-server

一个提供Mercado Pago支付集成工具的MCP协议服务器,支持文档搜索等功能。

article

README

🚀 Mercado Pago MCP 服务器演示

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 凭证:

  1. 配置 MCP 服务器在你的 IDE 中 要与 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”
显示 3 个中的 8 个结果

## 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
        }
    ]
}
help

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client