SpherePay

Name: SpherePay
Author: danchev

本地服务

github.com/danchev金融数据034 周前更新

代码仓库

关于 SpherePay

SpherePay 是面向 SpherePay 支付平台的 MCP 服务，可通过 Claude 管理客户、资金账户、转账及相关操作。它结合多步骤工作流与只读查询，并提供转账幂等处理和输入校验。

主要功能

01客户开户与验证
02银行账户和钱包设置
03支持幂等的转账
04虚拟账户与出金
05Webhook 和事件查询
06输入校验与日志个人信息脱敏

适用场景

01为个人或企业客户办理开户
02设置法币或加密货币资金账户
03在不同资金工具间转账
04追踪转账和 Webhook 事件

MCP 相关

向 MCP 客户端提供 24 个 SpherePay 工具，包括多步骤操作工作流和只读记录查询。可连接 Claude Desktop 或其他兼容客户端。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "danchev-spherepay": {
      "command": "uvx",
      "args": [
        "spherepay-mcp"
      ],
      "env": {
        "SPHEREPAY_API_KEY": "<SPHEREPAY_API_KEY>",
        "SPHEREPAY_BASE_URL": "<SPHEREPAY_BASE_URL>",
        "SPHEREPAY_TIMEOUT": "<SPHEREPAY_TIMEOUT>",
        "SPHEREPAY_MAX_RETRIES": "<SPHEREPAY_MAX_RETRIES>"
      }
    }
  }
}

启动命令uvx spherepay-mcp

需要配置的环境变量

SPHEREPAY_API_KEY密钥Your SpherePay API key (Bearer token). Get one at https://dashboard.spherepay.co

SPHEREPAY_BASE_URLAPI base URL. Use https://api.sandbox.spherepay.co for testing or https://api.spherepay.co for production.

SPHEREPAY_TIMEOUTRequest timeout in seconds (default: 30)

SPHEREPAY_MAX_RETRIESMaximum retry attempts for transient failures (default: 3)

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

pypispherepay-mcp0.0.1stdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

SpherePay MCP 服务

一个适用于 SpherePay 支付平台的 Model Context Protocol 服务。可直接通过 Claude 管理客户、银行账户、钱包、转账、虚拟账户、Webhook 和 CCTP 出金。

功能

24 个精选工具——9 个用于多步操作的工作流工具，15 个用于即时查询的只读工具
自动重试，支持指数退避和速率限制处理
转账支持幂等性——安全去重重复请求
日志中屏蔽 PII——绝不记录账户号码、路由号码和个人数据
在工具边界验证输入——在进行任何 API 调用之前验证 ID、货币、网络和金额
桌面扩展（.mcpb），支持一键安装到 Claude Desktop

工具

工作流工具

工具	描述
`onboard_customer`	创建客户（个人或企业），并生成 TOS/KYC 验证链接
`verify_customer`	两步验证：发送 OTP，然后通过人脸识别进行验证
`setup_funding`	为客户创建银行账户（USD/EUR）或加密货币钱包
`execute_transfer`	在资金工具之间转账，并自动确保幂等性
`onboard_business_rep`	创建并验证企业代表
`setup_virtual_account`	创建虚拟账户，以便自动将法币转换为稳定币
`setup_offloader_wallet`	创建出金钱包，用于将稳定币兑换为法币
`create_webhook`	通过 HTTPS Webhook 订阅事件通知
`submit_cctp_offramp`	提交 CCTP 销毁交易，以兑换跨链出金

只读工具

工具	描述
`get_customer` / `list_customers`	获取客户详情和验证状态
`get_transfer` / `list_transfers`	获取转账信息及状态，并按客户、状态或类型筛选
`get_bank_account` / `list_bank_accounts`	获取银行账户详情，并按客户筛选
`get_wallet` / `list_wallets`	获取钱包详情，并按客户筛选
`get_virtual_account` / `list_virtual_accounts`	获取虚拟账户详情和存款说明
`list_virtual_account_transfers`	列出虚拟账户的存款和兑换记录
`get_offloader_wallet` / `list_offloader_wallets`	获取出金钱包详情和出金配置
`get_webhook`	获取 Webhook 详情和投递状态
`get_event`	获取事件详情和 Webhook 投递记录

支持的货币和网络

货币	类型
`usd`、`eur`	法币
`usdc`、`usdt`、`eurc`	稳定币

网络	类型
`ach`、`wire`、`sepa`	法币支付通道
`ethereum`、`polygon`、`sol`、`base`、`arbitrum`、`tron`、`avalanche`、`optimism`	区块链

安装

前提条件

Python 3.12+
SpherePay API 密钥（在此获取）

Claude Desktop（stdio）

将以下内容添加到 Claude Desktop 配置文件（claude_desktop_config.json）中：

{
  "mcpServers": {
    "spherepay": {
      "command": "uvx",
      "args": ["spherepay-mcp"],
      "env": {
        "SPHEREPAY_BASE_URL": "https://api.sandbox.spherepay.co",
        "SPHEREPAY_API_KEY": "your_api_key_here"
      }
    }
  }
}

桌面扩展

从 GitHub Releases 下载最新的 .mcpb 文件，然后双击即可安装到 Claude Desktop。

独立运行

git clone https://github.com/danchev/spherepay-mcp.git
cd spherepay-mcp
uv sync
uv run spherepay-mcp

配置

变量	必填	默认值	描述
`SPHEREPAY_API_KEY`	是	—	你的 SpherePay API 密钥（Bearer 令牌）
`SPHEREPAY_BASE_URL`	否	`https://api.sandbox.spherepay.co`	API 基础 URL。生产环境请使用 `https://api.spherepay.co`
`SPHEREPAY_TIMEOUT`	否	`30`	请求超时时间，单位为秒
`SPHEREPAY_MAX_RETRIES`	否	`3`	瞬时故障（429、5xx）的最大重试次数