razorpay-mcp

Razorpay MCP 服务

使用 Model Context Protocol 将您的 Razorpay 支付网关连接到 AI 助手

用于与 Razorpay 支付网关 API 交互的 Model Context Protocol（MCP）服务。此软件包可让 Cursor、Claude 和 Copilot 等 AI 助手通过标准化接口直接访问您的 Razorpay 账户数据。

快速开始

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

# Install globally first
npm install -g [email protected]

# Then use the binary directly
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 服务：

# Install globally first
npm install -g [email protected]

# Then use the binary directly
razorpay-mcp-sse --key-id rzp_test_yourkeyid --key-secret yoursecretkey --port 3001

2. 从您的 Web 应用连接：

// Create SSE connection
const eventSource = new EventSource('http://localhost:3001/sse');

// Handle connection event
eventSource.onmessage = (event) => {
  const data = JSON.parse(event.data);
  
  // If this is a hello message, store the sessionId
  if (data.type === 'hello') {
    const sessionId = data.sessionId;
    console.log(`Connected with session ID: ${sessionId}`);
    
    // Now you can make API calls
    callRazorpayAPI(sessionId, 'getAllPayments', {count: 10});
  }
};

// Send API requests
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 镜像

# Clone the repository
git clone https://github.com/yourusername/razorpay-mcp.git
cd razorpay-mcp

# Build the Docker image
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 文档
• Model Context Protocol

许可证

Apache-2.0