项目简介

Paytm MCP Server 是一个基于 Model Context Protocol (MCP) 构建的后端应用，旨在为 AI 代理和开发者提供安全、标准化的方式访问 Paytm 的支付和商业支付 API。它通过 MCP 协议暴露 Paytm 的能力，使得 AI 应用能够理解并执行与支付相关的任务。

主要功能点

本项目提供以下核心功能，通过 MCP 工具的形式暴露给 AI 客户端：

• 创建支付链接: 根据指定的收款人、用途、金额以及客户联系方式（邮箱或手机号），生成一个用于收款的支付链接。
• 获取支付链接列表: 查询并列出商户创建的所有支付链接的详细信息，包括链接ID、名称、短链接、状态、创建日期和过期日期。
• 获取支付链接的交易详情: 根据支付链接的 ID，查询该链接下所有相关交易的详细信息，包括交易ID、订单ID、金额、状态、完成时间以及客户联系方式。

安装步骤

要安装并运行 Paytm MCP Server，请遵循以下手动步骤：

1. 克隆仓库:

   git clone https://github.com/paytm/payment-mcp-server.git
   cd payment-mcp-server
   

2. 创建并激活虚拟环境:

   uv venv
   source .venv/bin/activate
   

   (注: 'uv' 是一个快速的 Python 包管理器，如果未安装请先安装)
3. 安装依赖:

   uv pip install .
   

服务器配置

Paytm MCP Server 设计用于通过 MCP 客户端（如 Claude Desktop）启动和管理。您需要在 MCP 客户端的配置文件中指定如何启动此服务器。配置信息通常是 JSON 格式，您需要提供服务器的名称、启动命令及其参数，以及必要的环境变量。

关键配置信息示例（请根据您的环境调整路径）：

• 服务器名称: 'paytm-mcp-server' (或您希望的任何名称)
• 启动命令 (command): 用于执行 Python 的命令路径，例如 'uv path' (使用 uv 运行器) 或 'python'。
• 启动参数 (args): 启动服务器脚本的参数，例如 '--directory path/to/your/project run paytm_mcp.py' (使用 uv) 或 'path/to/your/project/paytm_mcp.py' (直接使用 python)。请确保 'paytm_mcp.py' 文件路径正确。
• 环境变量 (env): 必须包含您的 Paytm 商户凭据。
  • 'PAYTM_MID': 您的 Paytm 商户 ID。
  • 'PAYTM_KEY_SECRET': 您的 Paytm 密钥。

重要提示: 请将实际的 Paytm 凭据配置到 MCP 客户端的环境变量中，不要直接硬编码在公共文件中。

基本使用方法

1. 确保您已按照上述步骤安装了服务器代码和依赖。
2. 在您的 MCP 客户端（如 Claude Desktop）中，根据上一节的说明配置并启动 Paytm MCP Server。
3. 配置完成后，通过您的 MCP 客户端（如通过 AI 聊天界面或终端）与 AI 代理交互。
4. AI 代理将能够识别并调用 Paytm MCP Server 提供的工具（例如，当您发出“创建一个收款链接”的指令时，AI 会调用 'create_payment_link' 工具）。
5. AI 代理会根据工具的描述（docstring 中的说明）向您询问必要的参数（如收款人、金额等）。
6. 工具执行后，Paytm MCP Server 会处理请求并返回结果给 AI 客户端，AI 客户端再将结果以友好的方式呈现给您。