stablevoy-mcp

Name: stablevoy-mcp
Author: stablevoy

本地服务

github.com/stablevoy金融数据0今天更新

代码仓库

关于 stablevoy-mcp

stablevoy-mcp 将 AI 助手连接到 Stablevoy 非托管 USDT 和 USDC 支付网关。它可在选定商店中创建和管理发票；API 密钥不能转移资金或更改商店设置。

主要功能

01创建和取消发票
02查询发票状态及收款
03列出并查看商店
04筛选发票记录
05可选只读模式

适用场景

01向客户发送付款链接
02确认发票是否已付款
03查看多个商店的近期发票

MCP 相关

该 MCP 服务向 Claude Desktop、Claude Code 和 Cursor 等 MCP 客户端提供商店与发票工具。商店 API 密钥可用于发票操作和查询，但不能转移资金或更改收款设置。

配置

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

mcp.json · 通用配置

{
  "mcpServers": {
    "stablevoy-stablevoy": {
      "command": "npx",
      "args": [
        "-y",
        "stablevoy-mcp"
      ],
      "env": {
        "STABLEVOY_API_KEY": "<STABLEVOY_API_KEY>",
        "STABLEVOY_MCP_READ_ONLY": "<STABLEVOY_MCP_READ_ONLY>"
      }
    }
  }
}

启动命令npx -y stablevoy-mcp

需要配置的环境变量

STABLEVOY_API_KEY密钥A store API key (sk_live_...) for one store. Leave unset to use the keys of npx stablevoy-mcp login; with neither, the store tools answer not_signed_in and the documentation works.

STABLEVOY_MCP_READ_ONLYtrue leaves create_invoice and cancel_invoice out: read tools only.

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

安装包

npmstablevoy-mcp0.4.1stdio

工具

还没有获取到工具列表

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

详细介绍

stablevoy-mcp

适用于 Stablevoy 的 MCP 服务。Stablevoy 是一个非托管型 USDT 和 USDC 支付网关。你可以让 AI 助手向客户收款、查询发票是否已付款，或汇总本周的收款情况，涵盖你的所有商店：

“向 Acme 收取 250 美元，费用是 10 月的工作”会生成付款链接。
“Acme 付钱了吗？”会返回状态和交易记录。
“Main 商店本周收到了多少款？”会返回列表。

它适用于 Claude Desktop、Claude Code、Cursor 以及任何支持 Model Context Protocol 的客户端。它运行在你的电脑上，只与 Stablevoy API 通信。

它能做什么，不能做什么

该服务只保存商店 API 密钥。使用这些密钥，它可以创建收款发票、取消未付款发票，以及读取你的商店和发票。它无法转移资金、更改收款地址、Webhook、限额、密钥或商店；这些操作需要你在 Stablevoy 控制面板中使用钱包签名。Stablevoy 不会保管你的资金，因此没有需要提取的款项。

因此，即使助手受到恶意网页或文档的诱骗，也只能创建向你付款的发票、取消未付款发票（买家会收到提示，不要支付该发票，你的商店也会收到 invoice.cancelled Webhook），以及读取你的发票。真正的风险在于读取：发票金额和你的备注。在将该服务连接到也会读取不可信内容的助手之前，请牢记这一点；或者将其设为只读（见下文）。

连接

需要 Node.js 22.12 或更高版本。

npx stablevoy-mcp login

这会在浏览器中打开 Stablevoy 控制面板。使用钱包登录，勾选助手可以使用的商店并批准。浏览器会将一次性代码传回这台电脑上的命令，命令会用此代码为每个商店换取一个 API 密钥，并将其保存在你的配置文件夹中（Linux 上为 ~/.config/stablevoy-mcp，macOS 上为 ~/Library/Application Support/stablevoy-mcp，Windows 上为 %APPDATA%\stablevoy-mcp），且仅你本人可读取。这些密钥在控制面板的商店页面中显示为“MCP（你的电脑）”，你可以随时撤销其中任何一个。

然后将该服务添加到你的客户端。

Claude Desktop（claude_desktop_config.json）、Cursor（.cursor/mcp.json）和大多数客户端：

{
  "mcpServers": {
    "stablevoy": { "command": "npx", "args": ["-y", "stablevoy-mcp"] }
  }
}

Claude Code：

claude mcp add stablevoy -- npx -y stablevoy-mcp

单个商店，无需登录

在控制面板的商店页面创建密钥，然后改为传入该密钥：

{
  "mcpServers": {
    "stablevoy": { "command": "npx", "args": ["-y", "stablevoy-mcp"], "env": { "STABLEVOY_API_KEY": "sk_live_..." } }
  }
}

只读

在 env 中添加 "STABLEVOY_MCP_READ_ONLY": "true"：此时不会提供 create_invoice 和 cancel_invoice。

更改商店

再次运行 npx stablevoy-mcp login：这台电脑当前关联的商店会被勾选；取消勾选即可移除。被移除商店的密钥会撤销，新选择会取代旧选择。
npx stablevoy-mcp stores 会列出这台电脑关联的商店；npx stablevoy-mcp stores remove "Main" 会移除一个商店并撤销其密钥。
npx stablevoy-mcp logout 会撤销这台电脑的所有密钥并删除文件。

添加商店始终需要通过浏览器进行，因为这需要你的钱包。助手无法更改商店集合。多个账户或集合：在这些命令中使用 --profile work，并在客户端配置中设置 "STABLEVOY_MCP_PROFILE": "work"。

工具

工具	功能
list_stores	已连接的商店、每家商店是否可以收款，以及其 EVM 出款状态。
get_store	商店的设置：网络、出款地址、EVM 出款状态、发票限额、手续费、网站、返回 URL 和 webhook URL。仅供读取。
create_invoice	创建一张指定美元金额（如 “19.99”）的发票，可选提供参考信息、返回 URL 和付款时限（expiresInMinutes，15 至 10080；省略时使用商店默认值）；返回付款链接，由你自行发送给买家。相同金额和参考信息会返回同一张发票，而不会创建第二张。
cancel_invoice	取消一张尚未收到付款的发票，以便告知买家不要付款。之后仍到账的款项会将发票标记为 paid_late。
get_invoice	根据 ID 获取发票及已收到的付款。
list_invoices	按最新顺序列出发票，可按状态、来源、搜索内容和创建天数筛选。

如果有多个商店，工具会接受 store 参数（来自 list_stores 的 ID 或确切名称）；服务会要求你提供该参数，而不是自行猜测。

配置

变量	含义
STABLEVOY_API_KEY	单个商店密钥；设置后不会使用登录密钥。
STABLEVOY_MCP_PROFILE	要使用的登录配置，默认为 `default`。
STABLEVOY_MCP_READ_ONLY	设为 `true` 时，不提供 create_invoice 和 cancel_invoice。
STABLEVOY_API_URL	API，默认为 `https://api.stablevoy.com`。