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 の使用方法

この MCP サーバーは Docker を使って実行することもできます。

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