switch MCP

支付MCP服务器

一个用于通过您的支付网关API自动化创建支付意图的模型上下文协议（MCP）服务器。

🚀 快速入门

1. 安装依赖项

pip install -r requirements.txt

2. 配置API设置

更新 config.json 使用您实际的API凭据：

{
  "base_url": "https://edge-dp-switch.axis.razorpayevhq.in",
  "x_key_id": "your_actual_key_id",
  "x_merchant_id": "your_actual_merchant_id"
}

3. 测试基本功能

python test_basic.py

4. 运行MCP服务器

python run_server.py

🔧 当前功能

可用的MCP工具： create_payment_intent

描述为UPI支付创建一个新的支付意图

输入参数：

• amount （整数，必填）：支付金额，单位为派萨（例如，10010 = 100.10卢比）
• vpa (字符串，必填)：商户VPA地址（例如，“merchant@bank”）

自动生成:

• reference_id独特的参考示例如 ord_1703123456_7890
• currency已更正为“INR”
• description已更改为“测试支付”
• upi_initiation_mode已修复为“04”

在Claude桌面版中的示例用法：

Create a payment intent for ₹150.50 with VPA merchant123@axis

📋 已实施的内容

✅ 项目结构简洁、模块化的Python包 ✅ 配置管理基于JSON的配置文件，带有验证功能 ✅ HTTP 客户端带有适当错误处理的异步HTTP客户端\ ✅ 参考ID生成自动生成的唯一标识符 ✅ MCP工具集成单一工具用于创建支付意向 ✅ 输入验证基于Pydantic的参数验证 ✅ 记录日志用于调试的结构化日志记录 ✅ 表示“正确”或“完成”。 错误处理全面的错误信息

🔜 下一步行动

❌（这个符号在中文中通常没有直接的对应翻译，它表示“错误”或“禁止”的意思，可以理解为“错误”或“不对”。） X-签名生成需要实现签名认证 ❌ API测试签名准备好后，使用实际API进行测试 ❌（这个符号在中文中通常表示“错误”或“不正确”的意思，但直接翻译为文字时，我们可能需要根据上下文来解释其含义。若仅作为符号使用，可保留原样或解释为“错误”） Claude桌面集成添加到Claude Desktop MCP配置中 ❌（表示错误或禁止的符号，无具体中文对应词汇，可理解为“错误”或根据上下文翻译为“禁止”等） 附加工具更多的支付操作（状态查询、取消等）

🛠️ 项目结构

payment_mcp_server/
├── __init__.py              # Package initialization
├── main.py                  # MCP server entry point
├── config.py                # Configuration management
├── api_client.py            # HTTP client for API calls
config.json                  # API configuration
requirements.txt             # Python dependencies
run_server.py               # Simple server runner
test_basic.py               # Basic functionality tests

🔐 安全注意事项

• X-签名当前缺失 - 您需要提供签名生成逻辑
• 配置保留 config.json 安全存储，切勿提交实际API密钥
• 记录（日志）生产环境中不记录敏感数据

📞 与Claude桌面版的使用

一旦实现了X-Signature，请将其添加到您的Claude Desktop MCP配置中：

{
  "mcpServers": {
    "payment-mcp-server": {
      "command": "python",
      "args": ["/path/to/your/run_server.py"]
    }
  }
}

🐞 故障排除

1. 配置验证错误检查所有必填字段是否已填写 config.json
2. 导入错误确保您已安装所有必需的组件： pip install -r requirements.txt
3. MCP连接问题验证服务器是否正在运行，以及Claude Desktop的配置是否正确

______________________________________________________________________

状态准备实施X-Signature功能！ 🔒