Razorpay MCP Server (Official)

Name: Razorpay MCP Server (Official)
Author: razorpay

本地服务

razorpay.com金融数据2311 天前更新

代码仓库访问官网

关于 Razorpay MCP Server (Official)

Razorpay MCP Server 是 Razorpay 官方提供的 MCP 服务，将支付、订单、退款、结算等 Razorpay API 能力暴露给 AI 工具。适合开发者和需要自动化支付运营的团队使用，可选择远程托管或本地部署。

主要功能

01覆盖支付、支付链接、订单与退款等接口
02提供远程托管与本地部署两种方式
03支持通过 TOOLSETS 与 READ_ONLY 限制功能
04包含结账集成代码生成工具
05支持 Docker 与 Go 源码构建

适用场景

01查询支付状态并获取退款明细
02创建支付链接并通过短信或邮件发送
03生成 Razorpay 标准结账的集成代码

MCP 相关

该项目是 MCP 服务，向 MCP 客户端暴露 Razorpay 支付相关工具，远程方式通过 mcp-remote 连接 https://mcp.razorpay.com/mcp。

#razorpay #payments #fintech

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "razorpay": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "RAZORPAY_KEY_ID",
        "-e",
        "RAZORPAY_KEY_SECRET",
        "razorpay-mcp-server:latest"
      ],
      "env": {
        "RAZORPAY_KEY_ID": "<RAZORPAY_KEY_ID>",
        "RAZORPAY_KEY_SECRET": "<RAZORPAY_KEY_SECRET>"
      }
    }
  }
}

启动命令docker run -i --rm -e RAZORPAY_KEY_ID -e RAZORPAY_KEY_SECRET razorpay-mcp-server:latest

需要配置的环境变量

RAZORPAY_KEY_ID密钥

RAZORPAY_KEY_SECRET密钥

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

ocirazorpay-mcp-server:lateststdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

Razorpay MCP 服务（官方）

Razorpay MCP 服务是一个 Model Context Protocol（MCP）服务，可与 Razorpay API 无缝集成，为开发者和 AI 工具提供先进的支付处理能力。

快速开始

选择你偏好的设置方式：

远程 MCP 服务 - 由 Razorpay 托管，无需设置
本地 MCP 服务 - 在你自己的基础设施上运行

可用工具

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

Tool	描述	API	远程服务支持
`capture_payment`	将付款状态从已授权更改为已扣款。	Payment	✅
`fetch_payment`	使用 ID 获取付款详情	Payment	✅
`fetch_payment_card_details`	获取付款所用的银行卡详情	Payment	✅
`fetch_all_payments`	获取所有付款，支持筛选和分页	Payment	✅
`update_payment`	更新付款的备注字段	Payment	✅
`initiate_payment`	使用已保存的付款方式以及订单和客户详情发起付款	Payment	✅
`resend_otp`	如果未收到上一个 OTP 或其已过期，则重新发送 OTP	Payment	✅
`submit_otp`	验证并提交 OTP，以完成付款身份验证	Payment	✅
`create_payment_link`	创建新的标准付款链接	Payment Link	✅
`create_payment_link_upi`	创建新的 UPI 付款链接	Payment Link	✅
`fetch_all_payment_links`	获取所有付款链接	Payment Link	✅
`fetch_payment_link`	获取付款链接详情	Payment Link	✅
`send_payment_link`	通过短信或电子邮件发送付款链接。	Payment Link	✅
`update_payment_link`	更新标准付款链接	Payment Link	✅
`create_order`	创建订单	Order	✅
`fetch_order`	使用 ID 获取订单	Order	✅
`fetch_all_orders`	获取所有订单	Order	✅
`update_order`	更新订单	Order	✅
`fetch_order_payments`	获取订单的所有付款	Order	✅
`create_refund`	创建退款	Refund	❌
`fetch_refund`	使用 ID 获取退款详情	Refund	✅
`fetch_all_refunds`	获取所有退款	Refund	✅
`update_refund`	使用 ID 更新退款备注	Refund	✅
`fetch_multiple_refunds_for_payment`	获取一笔付款的多笔退款	Refund	✅
`fetch_specific_refund_for_payment`	获取一笔付款的指定退款	Refund	✅
`create_qr_code`	创建二维码	QR Code	✅
`fetch_qr_code`	使用 ID 获取二维码	QR Code	✅
`fetch_all_qr_codes`	获取所有二维码	QR Code	✅
`fetch_qr_codes_by_customer_id`	使用客户 ID 获取二维码	QR Code	✅
`fetch_qr_codes_by_payment_id`	使用付款 ID 获取二维码	QR Code	✅
`fetch_payments_for_qr_code`	获取二维码对应的付款	QR Code	✅
`close_qr_code`	关闭二维码	QR Code	❌
`fetch_all_settlements`	获取所有结算	Settlement	✅
`fetch_settlement_with_id`	获取结算详情	Settlement	✅
`fetch_settlement_recon_details`	获取结算对账报告	Settlement	✅
`create_instant_settlement`	创建即时结算	Settlement	❌
`fetch_all_instant_settlements`	获取所有即时结算	Settlement	✅
`fetch_instant_settlement_with_id`	使用 ID 获取即时结算	Settlement	✅
`fetch_all_payouts`	使用银行账号获取所有付款详情	Payout	✅
`fetch_payout_by_id`	使用付款 ID 获取付款详情	Payout	✅
`fetch_tokens`	根据客户 ID 或联系电话获取所有已保存的付款方式	Token	✅
`revoke_token`	撤销客户已保存的付款方式（令牌）	Token	✅
`create_registration_link`	创建用于订阅注册的注册链接（身份验证链接）	Registration Link	❌
`detect_stack`	检测结账集成所用的项目语言/框架	N/A（MCP 集成辅助工具）	✅
`integrate_razorpay_checkout`	为受支持的框架生成端到端的 Razorpay 标准结账集成代码	N/A（MCP 集成辅助工具）	✅

使用场景

工作流自动化：使用 Razorpay MCP 服务自动化日常工作流。
Agent 应用：构建使用此 Razorpay MCP 服务与 Razorpay 支付生态系统交互的 AI 工具。

远程 MCP 服务（推荐）

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

远程 MCP 服务的优势

零配置：无需安装 Docker、Go 或管理本地基础设施
始终保持最新：自动更新至最新功能和安全补丁
高可用性：依托 Razorpay 稳健的基础设施，正常运行时间达 99.9%
降低延迟：通过优化路由和缓存，更快地响应 API 请求
增强安全性：采用安全的基于令牌的身份验证，并自动轮换令牌
无需维护：无需操心更新、补丁或服务维护

前提条件

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

macOS

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

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

Windows

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

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

验证安装

npx --version

在 Cursor 中使用

在 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 KEY 和 API SECRET

在 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 Desktop 中配置 MCP 服务：链接
如何安装 Claude Desktop：链接

在 VS Code 中使用

将以下内容添加到 VS Code 设置（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 的Agent 模式文档中了解有关 MCP 服务的更多信息。

身份验证

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

前往 Razorpay Dashboard，并导航至 Settings > API Keys
找到你的 API Key 和 API Secret：
- API Key 可在控制面板中查看
- API Secret 仅在你首次创建时生成一次。**重要提示：**如果你已经有 API Secret，请勿生成新的密钥
在终端中运行以下命令以生成商户令牌：
```
echo <RAZORPAY_API_KEY>:<RAZORPAY_API_SECRET> | base64
```
将 <RAZORPAY_API_KEY> 和 <RAZORPAY_API_SECRET> 替换为你的实际凭据
复制 Base64 编码的输出内容——这就是远程 MCP 服务所需的商户令牌

**注意：**部署本地 MCP 服务时，无需生成商户令牌，可直接使用 API Key 和 Secret。

本地 MCP 服务

如果你希望在自己的基础设施上运行 MCP 服务，或需要访问所有工具（包括远程服务中受限的工具），可以在本地部署该服务。

前提条件

Docker
Golang (Go)
Git

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

使用公开 Docker 镜像（推荐）

你可以直接使用 Razorpay 公开镜像。无需自行构建——只需复制粘贴以下配置，并确保已安装 Docker。

**注意：**要使用特定版本而不是最新版本，请在以下配置中将 razorpay/mcp 替换为 razorpay/mcp:v1.0.0（或你想使用的版本标签）。可在 Docker Hub 上查看可用标签。

在 Claude Desktop 中使用

这将使用公开的 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 替换为你的密钥。

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

在 VS Code 中使用

将以下内容添加到 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 替换为你的密钥。

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

在 VS Code 中使用

将以下内容添加到 VS Code 设置（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 的Agent 模式文档中了解有关 MCP 服务的更多信息。

从 Docker 构建（替代方案）

你需要克隆 Github 仓库，并使用 docker 构建 Razorpay MCP 服务的镜像。请确保系统已安装并运行 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-server:latest 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 Code 设置示例：

{
  "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（可选）：要启用的工具集列表，以逗号分隔（默认值："all"）
READ_ONLY（可选）：以只读模式运行服务（默认值：false）

命令行标志

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

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

调试服务

你可以使用标准 Go 调试工具排查服务问题。可以使用 --log-file 标志指定日志文件（默认为 ./logs）。

许可证

本项目采用 MIT 开源许可证。完整条款请参阅 LICENSE。

支持 Markdown

登录后评论

基本信息

许可证: MIT
作者: razorpay
语言: go
传输方式: stdio
收录时间: 2025年4月26日
最近更新: 1 天前

报告问题

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。

Razorpay MCP Server (Official)

关于 Razorpay MCP Server (Official)

主要功能

适用场景

MCP 相关

配置

工具

详细介绍

Razorpay MCP 服务（官方）

快速开始

可用工具

使用场景

远程 MCP 服务（推荐）

远程 MCP 服务的优势

前提条件

macOS

Windows

验证安装

在 Cursor 中使用

在 Claude Desktop 中使用

在 VS Code 中使用

身份验证

本地 MCP 服务

前提条件

使用公开 Docker 镜像（推荐）

在 Claude Desktop 中使用

在 VS Code 中使用

在 VS Code 中使用

从 Docker 构建（替代方案）

从源代码构建

配置

命令行标志

调试服务

许可证

评论

第一次接触 MCP？

MCP（Model Context Protocol）是什么？

MCP 服务和客户端有什么区别？

本地服务与远程服务怎么选？

如何在 Claude、Cursor 等客户端中安装服务？

收录的项目经过审核吗？“认证”标识代表什么？

我维护的项目已被收录，怎样认领？