Razorpay MCP Server 是一个 模型上下文协议(MCP) 服务器,它提供了与 Razorpay API 的无缝集成,使开发者和AI工具能够实现高级支付处理功能。
选择您偏好的设置方法:
目前,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 | 更新退款备注 | 退款 | ✅ |
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 | 获取联系人号码的所有保存支付方式 | 令牌 | ✅ |
revoke_token | 撤销客户的保存支付方式(令牌) | 令牌 | ✅ |
远程 MCP 服务器由 Razorpay 托管,并提供即时访问 Razorpay API 的功能,无需任何本地设置。这是大多数用户的推荐方法。
需要 npx 来使用 mcp 服务器。
您需要在系统中安装 Node.js,默认情况下包括 npm(Node 包管理器)和 npx(Node 包执行):
# 使用 Homebrew 安装 Node.js(包括 npm 和 npx)
brew install node
# 或者从 https://nodejs.org/ 下载
# 使用 Chocolatey 安装 Node.js(包括 npm 和 npx)
choco install nodejs
# 或者从 https://nodejs.org/ 下载
npx --version
在您的 Cursor 设置中的 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_config.json 中添加以下内容:
{
"mcpServers": {
"rzp-mcp-server": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.razorpay.com/mcp",
"--header",
"Authorization: Basic <Merchant Token>"
]
}
}
}
替换 <Merchant Token> 为您自己的 Razorpay 商户令牌。查看身份验证部分了解生成令牌的步骤。
在您的 VS Code 设置(JSON)中添加以下内容:
{
"mcp": {
"inputs": [
{
"type": "promptString",
"id": "merchant_token",
"description": "Razorpay 商户令牌",
"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 服务器使用商户令牌进行身份验证。要生成您的商户令牌:
登录到 Razorpay 控制台 并导航至设置 > API 密钥
查找您的 API 密钥和 API 秘密:
在终端中运行以下命令生成您的商户令牌:
echo <RAZORPAY_API_KEY>:<RAZORPAY_API_SECRET> | base64
替换 <RAZORPAY_API_KEY> 和 <RAZORPAY_API_SECRET> 为您实际的凭证
复制 base64 编码的输出 - 这就是您用于远程 MCP 服务器的商户令牌
注意:对于本地 MCP 服务器部署,您可以直接使用 API 密钥和秘密,而无需生成商户令牌。
对于希望在自己的基础设施上运行 MCP 服务器或需要访问所有工具(包括远程服务器中受限的工具)的用户,可以本地部署服务器。
要运行 Razorpay MCP 服务器,可以使用以下方法之一:
您可以直接使用公共 Razorpay 镜像。无需自行构建 - 只需复制粘贴以下配置,并确保 Docker 已安装。
注意:要使用特定版本而不是最新版本,请在以下配置中将
razorpay/mcp替换为razorpay/mcp:v1.0.0(或您所需的版本标签)。可用标签可以在 Docker Hub 上找到。
这将使用公共 Razorpay 镜像
在您的 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 为您自己的密钥。
在您的 VS Code 设置(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 为您自己的密钥。
在您的 VS Code 设置(JSON)中添加以下内容:
{
"mcp": {
"inputs": [
{
"type": "promptString",
"id": "razorpay_key_id",
"description": "Razorpay 密钥ID",
"password": false
},
{
"type": "promptString",
"id": "razorpay_key_secret",
"description": "Razorpay 密钥秘密",
"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 服务器的信息,请参阅 代理模式文档。
您需要克隆 GitHub 仓库并使用 docker 构建 Razorpay MCP 服务器的镜像。请确保 docker 已安装并在您的系统上运行。
# 运行服务器
git clone https://github.com/razorpay/razorpay-mcp-server.git
cd razorpay-mcp-server
docker build -t razorpay-mcp-server:latest .
一旦构建了 razorpay-mcp-server:latest Docker 镜像,您可以在上述配置中将其替换为公共镜像(razorpay/mcp)。
您可以直接从源代码构建,而不是使用 Docker,按照以下步骤操作:
# 克隆仓库
git clone https://github.com/razorpay/razorpay-mcp-server.git
cd razorpay-mcp-server
# 构建二进制文件
go build -o razorpay-m