项目简介

Juspay MCP (Model Context Protocol) 服务器是一个应用后端，旨在为AI代理和其他外部工具提供与 Juspay 支付处理基础设施和商户后台交互的标准化接口。它基于 Model Context Protocol 标准，使得大型语言模型（LLMs）和AI助手能够通过结构化、可发现的方式执行支付相关的复杂操作和管理任务。

主要功能点

• 双API覆盖: 提供访问 Juspay 核心支付 API 和商户后台 API 的工具集。
• MCP集成: 与支持 Model Context Protocol 的LLM和AI代理无缝集成。
• 可配置模式: 可以配置为只提供核心支付工具或只提供商户后台工具，通过环境变量控制。
• 丰富的工具集: 涵盖订单管理、支付处理、客户管理、卡片管理、UPI支付、优惠与钱包查询、网关管理、报表、用户管理、设置管理等功能。
• 多种传输协议支持: 支持标准输入输出 (Stdio) 和基于 HTTP/SSE 的传输协议。

安装步骤

1. 克隆仓库: 从 GitHub 克隆项目仓库到本地。

2. 安装依赖: 进入项目目录，使用 pip 安装 Python 依赖。推荐使用虚拟环境。

服务器配置 (供MCP客户端使用)

MCP服务器需要由兼容的MCP客户端（如 Claude 桌面应用或其他支持 MCP 的应用）启动和连接。客户端通常需要以下配置信息来启动并连接到 Juspay MCP 服务器：

• 服务器名称 (server name): 用于标识该 MCP 服务器的名称。例如，'juspay-mcp' (用于支付工具) 或 'juspay-dashboard-mcp' (用于后台工具)。
• 启动命令 (command) 及参数 (args): 告诉客户端如何启动 Juspay MCP 服务器进程。通常指向项目的 'main.py' 或 'stdio.py' 文件，并可能包含端口、模式等参数。
  • 例如，使用 Stdio 模式的命令可能是 'python stdio.py'。
  • 使用 HTTP/SSE 模式的命令可能是 'python main.py --port 8000 --mode http'。
  • 如果通过 Docker 运行，命令可能是 'docker run ... juspaydotin/juspay-mcp:latest'。
• 环境变量: Juspay MCP 服务器运行时需要必要的凭据和配置信息，这些通常通过环境变量提供给服务器进程。MCP客户端配置中可能需要包含将这些环境变量传递给服务器进程的设置。
  • 'JUSPAY_API_KEY': Juspay 提供的 API Key (核心支付工具需要)。
  • 'JUSPAY_MERCHANT_ID': 您的 Juspay 商户 ID (核心支付工具需要)。
  • 'JUSPAY_WEB_LOGIN_TOKEN': 用于访问 Juspay 商户后台的登录 Token (商户后台工具需要)。
  • 'JUSPAY_MCP_TYPE': 设置为 'CORE' (默认) 提供支付工具，设置为 'DASHBOARD' 提供商户后台工具。如果需要同时使用两类工具，需要启动两个服务器实例，分别设置不同的 'JUSPAY_MCP_TYPE' 和端口。
  • 'JUSPAY_ENV': 设置为 'sandbox' (默认) 或 'production'。

请参考您的 MCP 客户端文档，了解如何配置外部 MCP 服务器的启动命令、参数和环境变量。

基本使用方法

1. 设置环境变量: 根据您需要使用的工具类型（支付或后台）和环境（沙箱或生产），设置相应的环境变量，例如 'JUSPAY_API_KEY', 'JUSPAY_MERCHANT_ID', 'JUSPAY_WEB_LOGIN_TOKEN', 'JUSPAY_MCP_TYPE', 'JUSPAY_ENV'。可以在 '.env' 文件中或直接在您的 shell 环境中设置。
2. 启动服务器:
   • 对于需要与客户端直接通过标准输入输出通信的场景 (Stdio模式)，运行 'python stdio.py'。
   • 对于支持 HTTP/SSE 连接的客户端 (HTTP模式)，运行 'python main.py'。可以通过 '--port' 参数指定端口，通过 '--mode http' 显式指定模式（默认为 http）。
3. 连接客户端: 配置您的 MCP 客户端，使其能够启动并连接到 Juspay MCP 服务器（根据上述“服务器配置”部分的说明进行）。
4. 通过客户端交互: 一旦客户端成功连接到服务器，AI代理即可通过 MCP 协议发现并调用暴露的 Juspay 工具，执行相应的支付或后台管理操作。