关键词

Mercado Pago文档搜索LLM 工具API 集成开发者文档

项目简介

该项目是一个基于 Model Context Protocol (MCP) 实现的服务器应用。它充当大语言模型 (LLM) 客户端与 Mercado Pago API 之间的桥梁，专门提供访问 Mercado Pago 文档搜索功能的工具。通过此服务器，LLM 客户端可以直接调用工具来查询 Mercado Pago 的开发者文档，并将搜索结果作为上下文信息提供给 LLM。

主要功能点

  • Mercado Pago 文档搜索: 核心功能是提供一个名为 'search_documentation' 的工具，允许用户通过自然语言查询的方式搜索 Mercado Pago 的开发者文档。
  • 集成 LLM 客户端: 服务器遵循 MCP 标准，可以与任何支持 MCP 的 LLM 客户端（如某些 IDE 集成、桌面应用等）无缝集成。
  • API 凭证管理: 服务器负责安全地使用您提供的 Mercado Pago API 凭证进行认证，以访问 Mercado Pago 的内部搜索服务。
  • 结果格式化: 将搜索到的文档片段和链接格式化为易于 LLM 理解和呈现的文本格式（Markdown）。

安装步骤

  1. 克隆仓库: 使用 Git 克隆项目到本地。 
    git clone https://github.com/mercadolibre/demo-mercadopago-mcp-server.git
cd demo-mercadopago-mcp-server
  2. 安装依赖: 进入项目目录后，使用 npm 安装所有必需的依赖包。 
    npm install
  3. 获取 Mercado Pago API 凭证: 访问 Mercado Pago 开发者控制台获取您的应用 ID (CLIENT_ID) 和密钥 (CLIENT_SECRET)。这些凭证对于服务器连接 Mercado Pago API 是必需的。

服务器配置

MCP 服务器通常由 MCP 客户端（如支持 MCP 的 IDE 或桌面应用）启动和管理。您需要在客户端的设置中添加该服务器的配置信息。配置通常是一个 JSON 格式片段，指定如何启动服务器进程。

核心配置信息包括：

  • 服务器名称 (server name): 'mercadopago' (客户端用于识别该服务器的唯一名称)
  • 启动命令 (command): 'node' (用于执行服务器脚本的解释器或程序)
  • 参数 (args): '["/path/to/demo-mercadopago-mcp-server/build/index.js"]' (传递给启动命令的参数，这里是编译后的服务器脚本的完整路径。请根据您的实际克隆位置修改 '/path/to/...')
  • 环境变量 (env):
    • 'CLIENT_ID': 您的 Mercado Pago 应用 ID (必需)
    • 'CLIENT_SECRET': 您的 Mercado Pago 密钥 (必需)
    • 'DEBUG': 可选，设置为 '"true"' 可以启用详细的调试日志输出

请根据您的 MCP 客户端文档，将这些信息填入相应的服务器配置界面或文件中。

基本使用方法

配置完成后，当您在连接到此 MCP 服务器的 LLM 客户端中与 LLM 交互时，LLM 将能够感知并调用 'search_documentation' 工具。

您可以通过引导 LLM 使用该工具来查询 Mercado Pago 文档。例如，您可能会通过自然语言指示 LLM：“请帮我搜索一下 Mercado Pago 关于 Checkout Pro 的文档，使用西班牙语和阿根廷站点 (MLA)。”

LLM 客户端会将这个请求转化为 MCP 的 'callTool' 请求发送给此服务器，服务器执行搜索操作后，将格式化好的文档搜索结果返回给 LLM 客户端，供 LLM 使用和呈现给您。

例如，调用 'search_documentation' 工具时，需要提供以下参数：

  • 'language': 文档语言 ('es' 或 'pt')
  • 'query': 搜索关键词
  • 'siteId': 站点 ID ('MLA', 'MLB', 'MLM', 'MLU', 'MLC', 'MCO', 'MPE' 等)
  • 'limit': 可选，最大返回结果数量 (默认 10)

服务器将返回包含搜索结果（标题、内容摘要、链接、得分）的文本内容，通常以 Markdown 格式呈现。

信息

分类

开发者工具

访问项目