Payman AI MCP服务器

项目简介

本项目是一个基于 Model Context Protocol (MCP) 标准构建的服务器，旨在为大型语言模型 (LLM) 应用提供与 Payman AI 支付服务集成的能力。通过此 MCP 服务器，LLM 可以安全地调用 Payman AI 的 API，实现支付相关的操作，例如创建收款人、发送付款、查询余额等。

主要功能点

API密钥配置: 提供工具用于安全设置 Payman AI API 密钥。
收款人管理: 支持创建新的收款人。
支付功能: 允许通过 LLM 指示发送付款给指定的收款人。
余额查询: 提供查询当前账户余额的功能。
收款人搜索: 支持搜索已有的收款人信息。

安装步骤

克隆仓库:

git clone https://github.com/hrishi0102/payman_mcp.git
cd payman_mcp

安装依赖:
```
npm install
```
构建项目:
```
npm run build
```

服务器配置

为了让 MCP 客户端连接到 Payman AI MCP 服务器，您需要配置客户端的服务器信息。以下是一个 JSON 格式的配置示例，您需要将其添加到您的 MCP 客户端配置中。

{
  "serverName": "PaymanServer",
  "command": "node",
  "args": [
    "build/payman-server.js"
  ],
  "transport": "stdio"
}

配置参数说明:

'serverName': 服务器名称，设置为 "PaymanServer"。
'command': 启动服务器的命令，这里使用 'node' (请确保您的环境中已安装 Node.js)。
'args': 传递给启动命令的参数，指定服务器 JavaScript 文件的路径 'build/payman-server.js' (相对于仓库根目录)。
'transport': 通信协议，设置为 'stdio'，表示使用标准输入输出流进行通信。

重要提示:

确保您的 MCP 客户端支持 Stdio 传输协议。
您需要在运行 MCP 客户端之前，先按照安装步骤构建 Payman AI MCP 服务器。
启动 MCP 客户端后，客户端会根据配置尝试连接到 Payman AI MCP 服务器。

基本使用方法

启动 MCP 服务器: 按照上述配置在 MCP 客户端中启动 Payman AI MCP 服务器。
设置 API 密钥: 在 LLM 客户端中，使用 'set-api-key' 工具，并提供您的 Payman AI API 密钥。例如，在 Claude 或 Cursor 中，您可以输入类似 '#set-api-key apiKey="YOUR_API_KEY"' 的指令。
使用其他工具: 根据您的需求，使用其他工具如 'create-payee' (创建收款人), 'send-payment' (发送付款), 'search-payees' (搜索收款人), 'get-balance' (查询余额)。例如，创建收款人可以使用 '#create-payee name="John Doe" type="TEST_RAILS"'.

注意: 所有的工具调用都需要先使用 'set-api-key' 工具设置 API 密钥。请参考 Payman AI API 文档了解更多关于 API 密钥和可用参数的信息。

关键词