article
README
🚀 Mercado Pago MCP 服务器演示
Mercado Pago MCP 服务器是一个模型上下文协议(Model Context Protocol)服务器,它提供了一系列工具,能帮助你轻松地在应用程序中集成 Mercado Pago。
🚀 快速开始
安装与设置
-
克隆仓库:
git clone https://github.com/mercadolibre/demo-mercadopago-mcp-server.git cd demo-mercadopago-mcp-server -
安装依赖项:
npm install -
获取 Mercado Pago API 凭证 你需要通过环境变量提供有效的 Mercado Pago API 凭证:
- 在 Mercado Pago 开发者控制面板 获取你的凭证
CLIENT_ID:你的 Mercado Pago 应用程序 IDCLIENT_SECRET:你的 Mercado Pago 秘钥
- 配置 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
}
]
}
微信扫一扫