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 "
}
}
}
}替换 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 "
]
}
}
}替换 `` 使用您的Razorpay商家代币。检查身份验证部分以了解生成令牌的步骤。
使用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服务器使用基于商家令牌的身份验证。要生成您的商家令牌:
- 去 Razorpay仪表板 并导航到“设置”>“API密钥”
- 找到您的API密钥和API机密:
- API密钥在仪表板上可见 - API机密在您首次创建时仅生成一次。 重要提示: 如果您已经有一个秘密,请不要生成新的秘密
- 通过在终端中运行以下命令生成您的商家令牌:
echo : | base64替换 ` 和 ` 使用您的真实凭证
- 复制base64编码的输出-这是远程MCP服务器的商家令牌
注: 对于本地MCP服务器部署,您可以直接使用API密钥和机密,而无需生成商家令牌。
本地MCP服务器
对于喜欢在自己的基础架构上运行MCP服务器或需要访问所有工具(包括远程服务器中限制的工具)的用户,您可以在本地部署服务器。
先决条件
- 码头工人
- Golang(围棋)
- Git
要运行Razorpay MCP服务器,请使用以下方法之一:
使用公共Docker镜像(推荐)
您可以直接使用公开的Razorpay镜像。无需自己构建任何东西——只需复制粘贴下面的配置,并确保Docker已安装。
注: 要使用特定版本而不是最新版本,请替换razorpay/mcp和razorpay/mcp:v1.0.0(或您所需的版本标签)。可用标签可以在上找到 .
使用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 用你的钥匙。
使用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 用你的钥匙。
使用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": "",
"RAZORPAY_KEY_SECRET" : ""
}
}
}配置
服务器需要以下配置:
RAZORPAY_KEY_ID:您的Razorpay API密钥IDRAZORPAY_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)
许可证
该项目根据麻省理工学院开源许可证条款获得许可。请参考 许可证 完整的条款。
