项目简介

Razorpay MCP 服务器是一个遵循 Model Context Protocol (MCP) 的应用后端。它旨在让大型语言模型 (LLM) 应用能够无缝集成并调用 Razorpay 的支付处理功能,从而扩展 LLM 在金融、电商等领域的应用场景。

主要功能点

该服务器通过 MCP 标准暴露了一系列与 Razorpay 相关的能力,主要包括:

  • 支付查询: 允许 LLM 获取特定支付交易的详细信息。
  • 支付链接创建: 允许 LLM 创建用于收款的支付链接,指定金额、币种等信息。
  • 支付链接查询: 允许 LLM 获取已创建支付链接的状态和详细信息。
  • 订单创建: 允许 LLM 创建 Razorpay 订单,用于管理更复杂的支付流程。
  • 订单查询: 允许 LLM 获取特定订单的详细信息。

通过这些功能,LLM 客户端(如支持 MCP 的 AI 助手或开发者工具)可以代表用户执行支付相关的操作或获取数据。

安装步骤

该服务器可以通过 Docker 容器或直接从源代码构建运行。具体步骤较为技术性,用户通常无需自行操作,而是由使用该服务器的 MCP 客户端(如特定的 IDE 扩展或 AI 助手应用)负责管理和启动。

对于需要自行安装和运行的开发者:

  1. 确保您的系统已安装 Docker 或 Go 语言环境及 Git。
  2. 克隆 GitHub 仓库:'git clone https://github.com/razorpay/razorpay-mcp-server.git'
  3. 进入仓库目录:'cd razorpay-mcp-server'
  4. 使用 Docker 构建镜像:'docker build -t razorpay-mcp-server:latest .' 或 从源代码构建二进制:'go build -o razorpay-mcp-server ./cmd/razorpay-mcp-server'
  5. 具体运行方式(如使用 'docker run' 或执行二进制)取决于您使用的 MCP 客户端的配置方式。

推荐方式是使用支持 MCP 的客户端,由客户端自动启动和管理服务器进程。

服务器配置

本 MCP 服务器需要您的 Razorpay API 密钥 ID 和密钥 Secret 才能与 Razorpay API 进行交互。这些敏感信息不应直接硬编码,而是通过环境变量或命令行参数提供给服务器进程。

当您在 MCP 客户端(例如 Claude Desktop 或 VS Code)中配置此服务器时,您需要告诉客户端如何启动这个服务器进程,并传递必要的配置信息。典型的配置会包含以下部分:

  • 服务器名称 (Server Name): 一个标识符,例如 'razorpay-mcp-server' 或 'razorpay'。这是 LLM 客户端内部用来引用此服务器的名称。
  • 启动命令 (Command): 启动服务器的可执行文件或脚本的路径。例如,如果您使用 Docker 镜像,命令可能是 'docker'。如果您从源代码构建了二进制,命令可能是 './razorpay-mcp-server'。
  • 命令参数 (Args): 传递给启动命令的参数。例如,对于 Docker,这可能包括运行镜像的参数;对于二进制,这可能包括选择 Stdio 传输模式 ('stdio')。这些参数也用于传递配置信息,例如 '--key' 和 '--secret' 或设置环境变量 '-e RAZORPAY_KEY_ID'。
  • 环境变量 (Env): 在启动服务器进程时设置的环境变量。这通常是传递敏感配置(如 API 密钥)的首选方式。您需要在此处设置 'RAZORPAY_KEY_ID' 和 'RAZORPAY_KEY_SECRET',并填入您自己的 Razorpay 密钥。

示例配置(概念描述,具体 JSON 格式请参考您的 MCP 客户端文档和仓库 README):

告诉 MCP 客户端:

  • 有一个 MCP 服务器叫 "razorpay"。
  • 启动它的命令是 "docker"。
  • 启动参数包括:运行并移除容器、使用交互式模式连接 Stdio、设置 'RAZORPAY_KEY_ID' 环境变量、设置 'RAZORPAY_KEY_SECRET' 环境变量、使用的 Docker 镜像名称是 'razorpay-mcp-server:latest'。
  • 为这个启动命令设置的环境变量是 'RAZORPAY_KEY_ID' 和 'RAZORPAY_KEY_SECRET',它们的值需要替换成您的真实 API 密钥。

重要提示: 请务必将配置中的占位符(如 'your_razorpay_key_id' 和 'your_razorpay_key_secret')替换为您在 Razorpay 后台获取的实际 API 密钥。妥善保管您的 API 密钥,避免泄露。

基本使用方法

正确安装并配置 MCP 服务器到您的 LLM 客户端后,LLM 应用即可通过 MCP 协议调用服务器提供的 Razorpay 功能。用户无需直接与服务器交互,而是通过与 LLM 对话或在支持的环境中使用 AI 功能来触发这些操作。

例如,在支持的 AI 聊天界面中,您可能可以这样请求:

  • "请帮我查询一下支付 ID 为 pay_xxxxxxxxxxxxxx 的详情。" (LLM 客户端会识别意图并调用服务器的 'payment.fetch' 功能)
  • "创建一个金额为 500 印度卢比的支付链接,描述是购买书籍。" (LLM 客户端会识别意图并调用服务器的 'payment_link.create' 功能)

服务器会执行相应的 Razorpay API 调用,并将结果返回给 LLM 客户端,最终以用户友好的方式呈现给您。

信息

分类

商业系统