Razorpay Mcp

razorpay-mcp

一个 MCP（Model Context Protocol）服务，可将 Claude 等 AI 助手直接连接到你的 Razorpay 账户。配置完成后，你可以用自然语言让 AI 获取付款信息、分析收入趋势、检查失败的交易、监控订阅，并查看实时业务仪表板，无需编写代码。

快速开始

# Clone
git clone https://github.com/indiamcp/razorpay-mcp

# Install
cd razorpay-mcp
npm install

# Configure
cp .env.example .env
# Add your Razorpay API keys to .env

# Build
npm run build

# Run
npm start

Claude Desktop 设置

将以下内容添加到你的 claude_desktop_config.json（在 macOS 上通常位于 ~/Library/Application Support/Claude/claude_desktop_config.json，在 Windows 上通常位于 %APPDATA%\Claude\claude_desktop_config.json）：

{
  "mcpServers": {
    "razorpay": {
      "command": "node",
      "args": ["/path/to/razorpay-mcp/dist/index.js"],
      "env": {
        "RAZORPAY_KEY_ID": "rzp_test_xxxxxxxxxxxx",
        "RAZORPAY_KEY_SECRET": "your_secret_here"
      }
    }
  }
}

也可以使用 npx（发布后）：

{
  "mcpServers": {
    "razorpay": {
      "command": "npx",
      "args": ["-y", "@indiamcp/razorpay-mcp"],
      "env": {
        "RAZORPAY_KEY_ID": "rzp_test_xxxxxxxxxxxx",
        "RAZORPAY_KEY_SECRET": "your_secret_here"
      }
    }
  }
}

可用工具

工具	描述	关键参数
get_payment	根据 ID 获取特定付款	payment_id
list_payments	根据筛选条件列出付款	from、to、count、status
get_payment_analytics	收入、成功率、支付方式明细	from、to
get_order	根据 ID 获取特定订单	order_id
list_orders	根据筛选条件列出订单	from、to、count、status、receipt
get_customer	根据 ID 获取特定客户	customer_id
list_customers	列出客户	count、skip
get_subscription	根据 ID 获取特定订阅	subscription_id
list_subscriptions	根据筛选条件列出订阅	from、to、count、status
get_subscription_analytics	活跃订阅数、流失率、即将续订的订阅	from、to
get_refund	获取特定退款	payment_id、refund_id
list_refunds	列出某笔付款的退款	payment_id、count
get_dashboard_summary	业务健康状况检查——今日／本周／本月收入	(无)
get_failed_payment_analysis	按支付方式和银行分析失败原因	from、to

示例提示词

连接后，可以尝试向 Claude 提问：

• “显示过去 7 天内所有失败的付款，并说明失败原因”
• “我这个月的总收入是多少？”
• “列出所有活跃订阅”
• “我的客户更喜欢哪种支付方式？”
• “显示本周注册的客户”
• “我这个月的订阅流失率是多少？”
• “查找付款 pay_xxxxx”
• “有多少笔退款仍在处理中？”
• “提供今天的业务仪表板摘要”
• “分析过去 30 天的付款失败情况”

安全说明

• 仅使用环境变量——从环境变量中读取 API 密钥，绝不硬编码或记录日志
• v1 版本为只读——此服务仅获取数据；无法创建付款、发放退款或修改任何记录
• 不存储数据——此服务绝不会持久化或缓存付款数据
• 开发期间使用测试密钥——Razorpay 测试密钥（rzp_test_*）安全可靠，不会产生真实扣款

开发

# Run in dev mode (no build needed)
npm run dev

# Type check
npm run lint

# Run tests
npm test

---

IndiaMCP 的一部分

此服务是 IndiaMCP 的一部分——一套面向印度 API 技术栈的开源 MCP 服务。

github.com/indiamcp