AI导哈

支付处理服务器

Razorpay MCP Server是一个提供高级支付处理功能的模型上下文协议服务器，支持与Razorpay API的无缝集成，适用于开发者和AI工具。

  • by razorpay
  • Go
  • 本地部署
  • 231 星标
  • 更新于
在 GitHub 查看 razorpay/razorpay-mcp-server

使用说明

Razorpay MCP服务器（官方）

Razorpay MCP服务器是 模型上下文协议（MCP） 该服务器与Razorpay API无缝集成，为开发人员和人工智能工具提供高级支付处理功能。

快速开始

选择您喜欢的设置方法：

可用工具

目前，Razorpay MCP服务器提供以下工具：

工具 说明 API 远程服务器支持
capture_payment 将付款状态从授权更改为已捕获。 支付 ✅
fetch_payment 使用ID获取付款详细信息 支付 ✅
fetch_payment_card_details 获取用于付款的卡详细信息 支付 ✅
fetch_all_payments 通过过滤和分页获取所有付款 支付 ✅
update_payment 更新付款的备注字段 支付 ✅
initiate_payment 使用已保存的付款方式以及订单和客户详细信息发起付款 支付 ✅
resend_otp 如果前一个OTP未收到或已过期，请重新发送OTP 支付 ✅
submit_otp 验证并提交OTP以完成支付认证 支付 ✅
create_payment_link 创建新的支付链接（标准） 支付链接 ✅
create_payment_link_upi 创建新的UPI支付链接 支付链接 ✅
fetch_all_payment_links 获取所有付款链接 支付链接 ✅
fetch_payment_link 获取付款链接的详细信息 支付链接 ✅
send_payment_link 通过短信或电子邮件发送付款链接。 支付链接 ✅
update_payment_link 更新新的标准支付链接 支付链接 ✅
create_order 创建订单 订单 ✅
fetch_order 使用ID获取订单 订单 ✅
fetch_all_orders 获取所有订单 订单 ✅
update_order 更新订单 订单 ✅
fetch_order_payments 获取订单的所有付款 订单 ✅
create_refund 创建退款 退款 ❌
fetch_refund 使用ID获取退款详细信息 退款 ✅
fetch_all_refunds 获取所有退款 退款 ✅
update_refund 使用ID更新退款通知 退款 ✅
fetch_multiple_refunds_for_payment 获取付款的多个退款 退款 ✅
fetch_specific_refund_for_payment 获取付款的特定退款 退款 ✅
create_qr_code 创建二维码 二维码 ✅
fetch_qr_code 获取带有ID的二维码 二维码 ✅
fetch_all_qr_codes 获取所有二维码 二维码 ✅
fetch_qr_codes_by_customer_id 获取带有客户ID的二维码 二维码 ✅
fetch_qr_codes_by_payment_id 获取带有付款ID的二维码 二维码 ✅
fetch_payments_for_qr_code 获取二维码付款 二维码 ✅
close_qr_code 关闭二维码 二维码 ❌
fetch_all_settlements 获取所有定居点 结算 ✅
fetch_settlement_with_id 获取结算明细 结算 ✅
fetch_settlement_recon_details 获取结算对账报告 结算 ✅
create_instant_settlement 创建即时结算 结算 ❌
fetch_all_instant_settlements 获取所有即时结算 结算 ✅
fetch_instant_settlement_with_id 使用ID获取即时结算 结算 ✅
fetch_all_payouts 获取所有带有账号的付款详细信息 支付 ✅
fetch_payout_by_id 使用支付ID获取支付详细信息 支付 ✅
fetch_tokens 按客户ID或联系电话获取所有已保存的付款方式 代币 ✅
revoke_token 撤销客户已保存的付款方式（令牌） 代币 ✅
create_registration_link 创建订阅注册的注册链接（auth链接） 注册链接 ❌
detect_stack 检测用于签出集成的项目语言/框架 不适用（MCP集成助手） ✅
integrate_razorpay_checkout 为支持的框架生成端到端的Razorpay标准Checkout集成代码 不适用（MCP集成助手） ✅

用例

  • 工作流程自动化：使用Razorpay MCP Server自动化您的日常工作流程。
  • 代理应用：使用此Razorpay MCP服务器构建与Razorpay支付生态系统交互的AI驱动工具。

远程MCP服务器（推荐）

远程MCP服务器由Razorpay托管，无需任何本地设置即可即时访问Razorpay API。这是大多数用户的推荐方法。

远程MCP服务器的优点

  • 零设置：无需安装Docker、Go或管理本地基础设施
  • 始终更新：自动更新最新功能和安全补丁
  • 高可用性：依托Razorpay强大的基础设施，正常运行时间为99.9%
  • 减少延迟：优化路由和缓存以实现更快的API响应
  • 增强安全性：基于令牌的安全身份验证，具有自动令牌轮换功能
  • 无需维护：无需担心更新、补丁或服务器维护

先决条件

npx 需要使用mcp服务器。 你需要在你的系统上安装Node.js，其中包括两者 npm （节点包管理器）和 npx 默认情况下（节点包执行）：

macOS

# Install Node.js (which includes npm and npx) using Homebrew
brew install node

# Alternatively, download from https://nodejs.org/

视窗

# Install Node.js (which includes npm and npx) using Chocolatey
choco install nodejs

# Alternatively, download from https://nodejs.org/

验证安装

npx --version

使用游标

在MCP的光标设置中，添加此配置。

{
  "mcpServers": {
    "rzp-mcp-server": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.razorpay.com/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Basic <Base64(key:secret)>"
      }
    }
  }
}

替换 key & secret 使用您的Razorpay API密钥和API机密

使用Claude Desktop

将以下内容添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "rzp-mcp-server": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.razorpay.com/mcp",
        "--header",
        "Authorization: Basic <Merchant Token>"
      ]
    }
  }
}

替换 <Merchant Token> 使用您的Razorpay商家代币。检查身份验证部分以了解生成令牌的步骤。

  • 了解如何在Claude桌面中配置MCP服务器： 链接
  • 如何安装Claude Desktop： 链接

使用VS代码

将以下内容添加到您的VS代码设置（JSON）中：

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "merchant_token",
        "description": "Razorpay Merchant Token",
        "password": true
      }
    ],
    "servers": {
      "razorpay-remote": {
        "command": "npx",
        "args": [
          "mcp-remote",
          "https://mcp.razorpay.com/mcp",
          "--header",
          "Authorization: Basic ${input:merchant_token}"
        ]
      }
    }
  }
}

在VS Code中了解有关MCP服务器的更多信息 代理模式文档.

认证

远程MCP服务器使用基于商家令牌的身份验证。要生成您的商家令牌：

  1. 去 Razorpay仪表板 并导航到“设置”>“API密钥”

  2. 找到您的API密钥和API机密：

    • API密钥在仪表板上可见
    • API机密在您首次创建时仅生成一次。 重要提示： 如果您已经有一个秘密，请不要生成新的秘密

  3. 通过在终端中运行以下命令生成您的商家令牌：

    echo <RAZORPAY_API_KEY>:<RAZORPAY_API_SECRET> | base64

    替换 <RAZORPAY_API_KEY> 和 <RAZORPAY_API_SECRET> 使用您的真实凭证

  4. 复制base64编码的输出-这是远程MCP服务器的商家令牌

注： 对于本地MCP服务器部署，您可以直接使用API密钥和机密，而无需生成商家令牌。

本地MCP服务器

对于喜欢在自己的基础架构上运行MCP服务器或需要访问所有工具（包括远程服务器中限制的工具）的用户，您可以在本地部署服务器。

先决条件

  • 码头工人
  • Golang（围棋）
  • Git

要运行Razorpay MCP服务器，请使用以下方法之一：

使用公共Docker镜像（推荐）

您可以直接使用公开的Razorpay镜像。无需自己构建任何东西——只需复制粘贴下面的配置，并确保Docker已安装。

注： 要使用特定版本而不是最新版本，请替换 razorpay/mcp 和 razorpay/mcp:v1.0.0 （或您所需的版本标签）。可用标签可以在上找到 Docker 中心.

使用Claude Desktop

这将使用公共剃须刀图像

将以下内容添加到您的 claude_desktop_config.json:

{
    "mcpServers": {
        "razorpay-mcp-server": {
            "command": "docker",
            "args": [
                "run",
                "--rm",
                "-i",
                "-e",
                "RAZORPAY_KEY_ID",
                "-e",
                "RAZORPAY_KEY_SECRET",
                "razorpay/mcp"
            ],
            "env": {
                "RAZORPAY_KEY_ID": "your_razorpay_key_id",
                "RAZORPAY_KEY_SECRET": "your_razorpay_key_secret"
            }
        }
    }
}

请更换 your_razorpay_key_id 和 your_razorpay_key_secret 用你的钥匙。

  • 了解如何在Claude桌面中配置MCP服务器： 链接
  • 如何安装Claude Desktop： 链接

使用VS代码

将以下内容添加到您的VS代码设置（JSON）中：

{
    "mcpServers": {
        "razorpay-mcp-server": {
            "command": "docker",
            "args": [
                "run",
                "--rm",
                "-i",
                "-e",
                "RAZORPAY_KEY_ID",
                "-e",
                "RAZORPAY_KEY_SECRET",
                "razorpay/mcp"
            ],
            "env": {
                "RAZORPAY_KEY_ID": "your_razorpay_key_id",
                "RAZORPAY_KEY_SECRET": "your_razorpay_key_secret"
            }
        }
    }
}

请更换 your_razorpay_key_id 和 your_razorpay_key_secret 用你的钥匙。

  • 了解如何在Claude桌面中配置MCP服务器： 链接
  • 如何安装Claude Desktop： 链接

使用VS代码

将以下内容添加到您的VS代码设置（JSON）中：

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "razorpay_key_id",
        "description": "Razorpay Key ID",
        "password": false
      },
      {
        "type": "promptString",
        "id": "razorpay_key_secret",
        "description": "Razorpay Key Secret",
        "password": true
      }
    ],
    "servers": {
      "razorpay": {
        "command": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "-e",
          "RAZORPAY_KEY_ID",
          "-e",
          "RAZORPAY_KEY_SECRET",
          "razorpay/mcp"
        ],
        "env": {
          "RAZORPAY_KEY_ID": "${input:razorpay_key_id}",
          "RAZORPAY_KEY_SECRET": "${input:razorpay_key_secret}"
        }
      }
    }
  }
}

在VS Code中了解有关MCP服务器的更多信息 代理模式文档.

从Docker构建（替代方案）

您需要克隆Github仓库，并使用以下命令为Razorpay MCP Server构建映像 docker。一定要确保 docker 已安装并在您的系统中运行。

# Run the server
git clone https://github.com/razorpay/razorpay-mcp-server.git
cd razorpay-mcp-server
docker build -t razorpay-mcp-server:latest .

一旦构建了razorpay mcp服务器：最新的docker镜像，您就可以替换公共镜像(razorpay/mcp)在上述配置中。

从源代码构建

您可以按照以下步骤直接从源代码构建，而不是使用docker：

# Clone the repository
git clone https://github.com/razorpay/razorpay-mcp-server.git
cd razorpay-mcp-server

# Build the binary
go build -o razorpay-mcp-server ./cmd/razorpay-mcp-server

构建完成后，您需要在 command 选项。以下是VS代码设置的示例：

{
  "razorpay": {
    "command": "/path/to/razorpay-mcp-server",
    "args": ["stdio","--log-file=/path/to/rzp-mcp.log"],
    "env": {
      "RAZORPAY_KEY_ID": "<YOUR_ID>",
      "RAZORPAY_KEY_SECRET" : "<YOUR_SECRET>"
    }
  }
}

配置

服务器需要以下配置：

  • RAZORPAY_KEY_ID：您的Razorpay API密钥ID
  • RAZORPAY_KEY_SECRET：您的Razorpay API密钥机密
  • LOG_FILE （可选）：服务器日志的日志文件路径
  • TOOLSETS （可选）：以逗号分隔的要启用的工具集列表（默认值：“全部”）
  • READ_ONLY （可选）：以只读模式运行服务器（默认值：false）

命令行标志

服务器支持以下命令行标志：

  • --key 或 -k：您的Razorpay API密钥ID
  • --secret 或 -s：您的Razorpay API密钥机密
  • --log-file 或 -l：日志文件的路径
  • --toolsets 或 -t：要启用的工具集列表，以逗号分隔
  • --read-only：以只读模式运行服务器

调试服务器

您可以使用标准的Go调试工具来解决服务器的问题。可以使用指定日志文件 --log-file 标志（默认为./logs）

许可证

该项目根据麻省理工学院开源许可证条款获得许可。请参考 许可证 完整的条款。

相关 MCP