Payman API MCP 服务器

这是一个 MCP（模型上下文协议）服务器，它提供了与 Payman AI 支付 API 的无缝集成，允许 AI 助手通过自然语言创建收款人、搜索现有收款人、发送支付以及检查余额。

概述

此 MCP 服务器公开了 Payman AI 的支付功能作为工具，这些工具可以被像 Claude 这样的大型语言模型应用程序使用。它使 AI 助手能够执行以下操作：

• 设置用于身份验证的 API 密钥
• 创建不同类型的收款人（TEST_RAILS、US_ACH、CRYPTO_ADDRESS）
• 向已注册的收款人发送支付
• 根据各种标准搜索收款人
• 检查账户余额

该实现遵循模型上下文协议（MCP）标准，确保与任何兼容 MCP 的客户端兼容。

特性

• 安全的 API 身份验证：在会话中安全地管理 API 密钥
• 多种收款人类型：
  • 用于测试的 TEST_RAILS 收款人
  • 用于美国银行转账的 US_ACH 收款人
  • 用于加密货币交易的 CRYPTO_ADDRESS 收款人
• 支付操作：
  • 发送带有自定义金额和备注的支付
  • 获取当前余额
• 搜索能力：
  • 根据姓名、联系方式、账户详情等搜索收款人
• 错误处理：所有 API 操作的全面错误处理
• 安全传输：支持 stdio 和 SSE（服务器发送事件）传输

先决条件

• Node.js（v14 或更高版本）
• npm 或 yarn
• 一个 Payman AI API 密钥

安装

通过 Smithery 安装

要通过 Smithery 自动安装 payman_mcp 供 Claude Desktop 使用：

npx -y @smithery/cli install @hrishi0102/payman_mcp --client claude

1. 克隆仓库：

   git clone https://github.com/yourusername/payman-mcp-server.git
   cd payman-mcp-server
   

2. 安装依赖项：

   npm install
   # 或者
   yarn install
   

3. 构建 TypeScript 代码：

   npm run build
   # 或者
   yarn build
   

配置

服务器不需要配置文件。API 密钥在运行时使用 set-api-key 工具设置。

运行服务器

标准 I/O 模式（适用于 Claude Desktop 等）

以 stdio 模式运行服务器，这与 Claude Desktop 和类似的 MCP 客户端兼容：

检查服务器是否正确设置：

node /ABSOLUTE/PATH/TO/PARENT/FOLDER/payman-mcp/build/payman-server.js

如果一切正常，现在你可以将 Payman MCP 服务器添加到任何客户端。

• 对于 Claude Desktop：这里
• 对于 Cursor：这里

服务器发送事件（SSE）模式（适用于 Web 集成）

要以 SSE 传输运行服务器（需要额外的依赖项：express 和 cors）：

node build/payman-server-sse.js

这将在端口 3001 上启动一个 Web 服务器，并具有以下端点：

• /sse - 服务器到客户端通信的 SSE 端点
• /messages - 客户端到服务器消息的端点

与 MCP 客户端集成

Claude Desktop

1. 打开你的 Claude Desktop 配置文件：

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json

2. 添加服务器配置：

   {
     "mcpServers": {
       "payman": {
         "command": "node",
         "args": ["/ABSOLUTE/PATH/TO/payman-mcp-server/build/payman-server.js"]
       }
     }
   }
   

3. 重启 Claude Desktop

其他 MCP 客户端

对于其他 MCP 客户端如 Cursor，请参阅其特定文档以添加 MCP 服务器。

使用指南

一旦服务器连接到 MCP 客户端，你可以使用以下工具：

设置 API 密钥

首先，你需要设置你的 Payman API 密钥：

请使用 set-api-key 工具并提供我的 Payman API 密钥：YOUR_API_KEY_HERE

创建收款人

测试轨收款人

创建一个名为“Test User”的测试收款人，标签为“test”

美国ACH收款人

创建一个美国ACH收款人，详情如下：
- 姓名：John Doe
- 账户类型：checking
- 账户号码：12345678
- 路由号码：111000025
- 账户持有人姓名：John Doe
- 账户持有人类型：individual

加密货币收款人

创建一个加密货币收款人，详情如下：
- 姓名：Crypto Wallet
- 地址：0x1234567890abcdef
- 区块链：ethereum
- 加密货币：ETH

发送支付

向收款人ID“pay_123abc”发送100的支付，备注为“每月服务”

搜索收款人

搜索所有名为“John”的收款人

检查余额

我的当前余额是多少？

工具参考

set-api-key

设置 Payman API 密钥进行身份验证。

• 参数：
  • apiKey (字符串)：Payman API 密钥

create-test-rails-payee

创建一个 TEST_RAILS 收款人用于测试。

• 参数：
  • name (字符串)：收款人的名称
  • type (字符串)：“TEST_RAILS”（默认）
  • tags (字符串数组)：可选的收款人标签

create-us-ach-payee

创建一个 US_ACH 收款人用于银行转账。

• 参数：
  • type (字符串)：“US_ACH”（默认）
  • accountType (枚举)：“checking”或“savings”
  • accountNumber (字符串)：银行账户号码
  • routingNumber (字符串)：路由号码
  • accountHolderName (字符串)：账户持有人的姓名
  • accountHolderType (枚举)：“individual”或“business”
  • name (字符串)：此收款人的名称
  • 附加可选参数（标签、联系详情）

create-crypto-payee

创建一个 CRYPTO_ADDRESS 收款人用于加密货币支付。

• 参数：
  • type (字符串)：“CRYPTO_ADDRESS”（默认）
  • address (字符串)：加密货币地址
  • chain (字符串)：使用的区块链
  • currency (字符串)：加密货币/代币
  • name (字符串)：此收款人的名称
  • 附加可选参数（标签、联系详情）

send-payment

向收款人发送支付。

• 参数：
  • payeeId (字符串)：付款的收款人ID
  • amountDecimal (数字)：发送的金额
  • walletId (字符串，可选)：特定的钱包
  • memo (字符串，可选)：支付备注
  • metadata (对象，可选)：附加元数据

search-payees

根据各种标准搜索收款人。

• 参数：多个可选搜索参数
  • name，contactEmail，accountNumber 等

get-balance

获取当前账户余额。

• 参数：无

错误处理

所有工具都包含适当的错误处理，并且如果发生以下情况，将返回描述性的错误信息：

• 未设置 API 密钥
• API 请求失败
• 提供了无效参数
• 出现网络问题

安全注意事项

• API 密钥在会话期间存储在内存中

• 服务器不会将任何凭据持久化到磁盘

• 所有对 Payman API 的请求都使用正确的授权头

• 模型上下文协议 用于 MCP 规范

• Payman AI 用于支付 API

• Zod 用于输入验证