返回 MCP 目录
public公开dns本地运行

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

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端