Razorpay MCP 服务器

使用模型上下文协议将您的 Razorpay 支付网关连接到 AI 助手

一个用于与 Razorpay 支付网关 API 交互的模型上下文协议 (MCP) 服务器。 此软件包使 Cursor、Claude 和 Copilot 等 AI 助手能够通过标准化接口直接访问您的 Razorpay 帐户数据。

快速开始

使用此软件包最可靠的方法：

# 首先全局安装
npm install -g razorpay-mcp@0.1.4

# 然后直接使用二进制文件
razorpay-mcp-stdio --key-id rzp_test_yourkeyid --key-secret yoursecretkey

Cursor 配置

全局安装后，将此配置添加到您的 .cursor/mcp.json 文件中：

{
  "mcpServers": {
    "razorpay": {
      "command": "razorpay-mcp-stdio",
      "args": [
        "--key-id",
        "rzp_test_yourkeyid",
        "--key-secret",
        "yoursecretkey"
      ]
    }
  }
}

对于 Windows 用户

{
  "mcpServers": {
    "razorpay": {
      "command": "cmd",
      "args": [
        "/c",
        "razorpay-mcp-stdio",
        "--key-id",
        "rzp_test_yourkeyid",
        "--key-secret",
        "yoursecretkey"
      ]
    }
  }
}

对于 Web 应用程序（使用 SSE）

1. 启动 SSE 服务器：

# 首先全局安装
npm install -g razorpay-mcp@0.1.4

# 然后直接使用二进制文件
razorpay-mcp-sse --key-id rzp_test_yourkeyid --key-secret yoursecretkey --port 3001

2. 从您的 Web 应用程序连接：

// 创建 SSE 连接
const eventSource = new EventSource('http://localhost:3001/sse');

// 处理连接事件
eventSource.onmessage = (event) => {
  const data = JSON.parse(event.data);
  
  // 如果这是 hello 消息，则存储 sessionId
  if (data.type === 'hello') {
    const sessionId = data.sessionId;
    console.log(`Connected with session ID: ${sessionId}`);
    
    // 现在您可以进行 API 调用
    callRazorpayAPI(sessionId, 'getAllPayments', {count: 10});
  }
};

// 发送 API 请求
async function callRazorpayAPI(sessionId, toolName, params) {
  const response = await fetch(`http://localhost:3001/messages?sessionId=${sessionId}`, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      type: 'toolCall',
      id: Date.now().toString(),
      name: toolName,
      params
    })
  });
  return response.json();
}

Docker 用法

您还可以使用 Docker 运行此 MCP 服务器：

构建 Docker 镜像

# 克隆存储库
git clone https://github.com/yourusername/razorpay-mcp.git
cd razorpay-mcp

# 构建 Docker 镜像
docker build -t razorpay-mcp .

运行容器

对于 stdio 传输（直接与 Cursor 一起使用）：

docker run --rm -it razorpay-mcp node dist/transports/stdio.cjs \
  --key-id rzp_test_yourkeyid --key-secret yoursecretkey

对于 SSE 服务器（用于 Web 应用程序）：

docker run --rm -p 3001:3001 razorpay-mcp node dist/transports/sse.cjs \
  --key-id rzp_test_yourkeyid --key-secret yoursecretkey --port 3001

可用的 Razorpay 工具

工具名称	描述	参数
getAllPayments	获取带有分页的付款	count, skip, from, to
getAllOrders	获取带有分页的订单	count, skip, from, to
getAllSettlements	获取带有分页的结算	count, skip, from, to
getAllRefunds	获取带有分页的退款	count, skip, from, to
getAllDisputes	获取带有分页的争议	count, skip, from, to
getAllInvoices	获取带有分页的发票	count, skip, from, to
getAllContacts	获取带有分页的联系人	count, skip, from, to
getAllTransactions	获取带有分页的交易	count, skip, from, to
getAllVPAs	获取虚拟支付地址	count, skip, from, to
getAllCustomers	获取带有分页的客户	count, skip, from, to
getAccountBalance	获取帐户余额	accountId

所有分页参数都是可选的：

• count: 要获取的项目数（默认值：10，最大值：100）
• skip: 要跳过的项目数
• from: 开始时间戳
• to: 结束时间戳

资源

• Razorpay API 文档
• 模型上下文协议

许可证

Apache-2.0