# @blindpay/mcp 中文文档

规范地址：https://npmcn.com/package/%40blindpay/mcp/

版本：1\.10\.2
npm 元数据更新时间：2026-11-06T18:10:35.283Z
中文译文更新时间：2026-11-08T06:56:10.762Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40blindpay/mcp
原文对照：https://npmcn.com/package/%40blindpay/mcp/?lang=original
项目主页：https://blindpay.com/
源码仓库：https://github.com/blindpaylabs/blindpay-mcp

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：1.1 MB，9 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=20\.0\.0
- 运行依赖：4 个
- peer 依赖：@types/node \>=20\.x\.x
- 首次发布：2026-01-05T14:04:33.929Z
- 最新版本发布：2026-11-06T18:10:34.904Z
- 近 30 天下载量：2007（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：24（近 12 个月 24 个）

## 中文简介

BlindPay API官方MCP服务器 - 全球支付稳定币API

## 安装

```sh
npm install @blindpay/mcp
```

也可以使用：`pnpm add @blindpay/mcp`、`yarn add @blindpay/mcp`、`bun add @blindpay/mcp`

## README

# BlindPay MCP 服务器![](https://npmcn.com/package/%40blindpay/mcp/assets/logo-512.png)

[![chat on Discord](https://img.shields.io/discord/856971667393609759.svg?logo=discord)](https://discord.gg/2DFKYaxjpp) [![twitter](https://img.shields.io/twitter/follow/blindpay?style=social)](https://twitter.com/intent/follow?screen_name=blindpay) [![npm version](https://img.shields.io/npm/v/@blindpay/mcp.svg)](https://www.npmjs.com/package/@blindpay/mcp) [![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_MCP-0098FF?logo=visualstudiocode)](https://vscode.dev/redirect/mcp/install?name=blindpay&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.blindpay.com%2Fmcp%22%7D)

官员 [示范背景协议](https://modelcontextprotocol.io/) 用于服务器 [盲页](https://blindpay.com/) - 全球支付稳定币API.

## 这个 MCP 服务器做什么

这个MCP服务器为AI助手(Cursor, Claude Code, Codex等)提供了访问BlindPay稳定币支付基础设施的机会. 它暴露了允许AI助手:

-   创建和管理客户(个人/企业)
-   处理多个区块链的付款和付款
-   创建引用并获得 FX 费率
-   管理虚拟账户和块链钱包
-   配置 Webhoks 和 API 密钥
-   还有...

## 连接的两种方式

|  | 远程服务器( 建议) | 当地 `npx` 服务器 |
| --- | --- | --- |
| URL / 命令 | `https://mcp.blindpay.com/mcp` | `npx -y @blindpay/mcp` |
| 认证 | OAuth 2.1 登录您的 BlindPay 账户( PKCE) | `BLINDPAY_API_KEY` 环境 var |
| 运输 | 可流取的 HTTP | 静态 |
| 在职 | Claude, ChatGPT, Cursor, VS代码, Grok, 任何远程能力客户端 | 任何 stdio MCP 客户端 |

两者都暴露出相同的工具,相同的服务器指令(呼叫命令,单位,测试量)和相同的webhook事件资源 `blindpay://webhooks/events`。远程服务器不需要 API 键:客户端打开一个浏览器,您签名并选择一个实例,而该符号被设定为您在其中的角色.

### 工具简介

设定 `BLINDPAY_MCP_PROFILE` 在本地服务器上选择哪些工具被曝光 :

| 简介 | 工具 | 使用时间 |
| --- | --- | --- |
| `full` (默认) | 每个公共API业务,包括付款和转账 | 与 AI 编码助理建立或操作 |
| `readonly` | `GET` 只有操作:状态、平衡、历史。 留下钱包的签名信息、 Webhook 秘密和webhook 门户访问工具,然后丢弃 `trace_id` 从JSON的回应,比如 `/mcp/readonly` | 消费者助理,或任何地方 移动金钱的工具是不必要的 |

每个工具都带有MCP说明(`readOnlyHint`, (中文(简体) ), `destructiveHint`, (中文(简体) ), `idempotentHint`)从它的HTTP动词中衍生出来,因此客户端可以自己来门确认.

## 先决条件( 仅本地服务器)

**获取您的 API 密钥和实例 ID :**

1.  [在 BlindPay 上创建账户](https://app.blindpay.com/sign-up)
2.  创建开发实例
3.  转到 [盲页板](https://app.blindpay.com/)
4.  选择实例并单击 **API 密钥** 选项卡
5.  创建新的 API 密钥
6.  复制您的实例标识( 格式 : `in_xxxxxxxxxxxx`从仪表板url

**您需要安装的依赖 :**

-   [节点.js](https://nodejs.org/en/download)
-   [无](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm)

您可以通过运行检查是否安装了节点. js `node -v`。同样的Npm,您可以通过运行检查 `npm -v`。 。 。 .

## 安装

### 光标

一击安装( 远程服务器, OAuth, 没有 API 密钥) :

[![Add to Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en-US/install-mcp?name=blindpay&config=eyJ1cmwiOiJodHRwczovL21jcC5ibGluZHBheS5jb20vbWNwIiwiYXV0aCI6eyJDTElFTlRfSUQiOiI0YzJyQWEwOERxYlZ2bm9uIiwic2NvcGVzIjpbInByb2ZpbGUiLCJlbWFpbCIsIm9mZmxpbmVfYWNjZXNzIl19fQ==)

或者加进去 `~/.cursor/mcp.json` 自己选择 **需要登录** 在 Cursor 的 MCP 设置中,并在您的 BlindPay 账户中签名 :

```json
{
  "mcpServers": {
    "blindpay": {
      "url": "https://mcp.blindpay.com/mcp",
      "auth": {
        "CLIENT_ID": "4c2rAa08DqbVvnon",
        "scopes": ["profile", "email", "offline_access"]
      }
    }
  }
}
```

Cursor只通过动态客户端注册或固定客户端ID进行签名,而BlindPay的登录没有注册端点,所以 `4c2rAa08DqbVvnon` 是BlindPay的公开OAuth客户端Cursor的ID. 保留 `scopes` 如所示:没有它, Cursor 要求每个登录服务器的广告范围, 而这三种广告以外的任何范围都会失败 `invalid_scope`。一个 `Authorization: Bearer` 头头在这里不工作:当服务器发布 OAuth 发现时, Cursor 忽略了配置头头. 光标插件在 [`plugins/cursor`](https://npmcn.com/package/%40blindpay/mcp/plugins/cursor) 设置此两个端点 .

一击安装( 有 API 密钥的本地服务器) :

[添加 MCP 到光标](https://cursor.com/en-US/install-mcp?name=blindpay&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBibGluZHBheS9tY3AiXSwiZW52Ijp7IkJMSU5EUEFZX0FQSV9LRVkiOiJ5b3VyLWFwaS1rZXktaGVyZSIsIkJMSU5EUEFZX0lOU1RBTkNFX0lEIjoieW91ci1pbnN0YW5jZS1pZC1oZXJlIn19Cg==)

安装后, 请将您的 API 密钥和实例 ID 添加到 `~/.cursor/mcp.json`数字 :

```json
{
  "mcpServers": {
    "blindpay": {
      "command": "npx",
      "args": ["-y", "@blindpay/mcp"],
      "env": {
        "BLINDPAY_API_KEY": "your-api-key-here",
        "BLINDPAY_INSTANCE_ID": "your-instance-id-here"
      }
    }
  }
}
```

### 克劳德代码

作为插件( 远程服务器, OAuth, 无 API 密钥) :

```bash
claude plugin marketplace add blindpaylabs/blindpay-mcp
claude plugin install blindpay@blindpay
```

或者作为一个简单的 MCP 服务器 :

```bash
claude mcp add --transport http blindpay https://mcp.blindpay.com/mcp
```

带有 API 密钥的本地服务器 :

```bash
claude mcp add --transport stdio blindpay --env BLINDPAY_API_KEY=your-api-key-here --env BLINDPAY_INSTANCE_ID=your-instance-id-here -- npx -y @blindpay/mcp
```

### 克劳德桌面

添加到您的 Claude 桌面配置文件 :

-   马可斯: `~/Library/Application Support/Claude/claude_desktop_config.json`
-   窗口 : `%APPDATA%\Claude\claude_desktop_config.json`

```json
{
  "mcpServers": {
    "blindpay": {
      "command": "npx",
      "args": ["-y", "@blindpay/mcp"],
      "env": {
        "BLINDPAY_API_KEY": "your-api-key-here",
        "BLINDPAY_INSTANCE_ID": "your-instance-id-here"
      }
    }
  }
}
```

### 代码

远程服务器( OAuth, 无 API 密钥) :

```bash
codex mcp add blindpay --url https://mcp.blindpay.com/mcp
```

带有 API 密钥的本地服务器 :

```bash
codex mcp add blindpay --env BLINDPAY_API_KEY=your-api-key-here --env BLINDPAY_INSTANCE_ID=your-instance-id-here -- npx -y @blindpay/mcp
```

或加进你的 `~/.codex/config.toml` (或项目范围d) `.codex/config.toml`:

```toml
[mcp_servers.blindpay]
command = "npx"
args = ["-y", "@blindpay/mcp"]

[mcp_servers.blindpay.env]
BLINDPAY_API_KEY = "your-api-key-here"
BLINDPAY_INSTANCE_ID = "your-instance-id-here"
```

### VS 代码

点击 **在 VS 代码中安装** 顶端的徽章,或添加到 `.vscode/mcp.json`数字 :

```json
{
  "servers": {
    "blindpay": {
      "type": "http",
      "url": "https://mcp.blindpay.com/mcp"
    }
  }
}
```

您也可以搜索 `@mcp blindpay` 在扩展视图中,一旦画廊条目被直播.

### 风起浪起

添加为 `~/.codeium/windsurf/mcp_config.json`数字 :

```json
{
  "mcpServers": {
    "blindpay": {
      "serverUrl": "https://mcp.blindpay.com/mcp"
    }
  }
}
```

### 雷克丝

打开 **示范背景协议登记处** 在Raycast中扩展, 搜索 `BlindPay` 并单击 **安装服务器**。或手动安装 `Manage Servers → Add Server` 使用 Cursor 区域中的本地配置.

### Claude(claude.ai/ Claude桌面,远程)

单位 **设置 / 连接器 / 添加自定义连接器**粘贴 `https://mcp.blindpay.com/mcp` 并完成登录。 只有只读工具才能被消费者目录所曝光.

### 聊天游戏

启用 **开发者模式** 内 **设置 / 连接器 / 高级**,则 **创建** 一个连接符 `https://mcp.blindpay.com/mcp` 和 OAuth 认证.

### 格鲁克

**Grok 构建插件( 建议) :** 安装 `blindpay` 从xAI插件市场。 该插件同时传送远程 HTTP MCP 端点:

| 服务器 | 網址 | 范围 |
| --- | --- | --- |
| `blindpay` | `https://mcp.blindpay.com/mcp` | 完整( 读 + 写) |
| `blindpay-readonly` | `https://mcp.blindpay.com/mcp/readonly` | 只读 |

两者都使用OAuth 2.1 (PKCE) 与您的 BlindPay 账户——没有API 键来粘贴.

**自定义连接器( 付费 Grok 级) :** 转到 [https://grok.com/ 连接器](https://grok.com/connectors) → **新建连接符** → **自定义**输入 `https://mcp.blindpay.com/mcp` (或只读的 URL) , 保留客户端证书为空, 并在提示时完成 BlindPay 签名 .

### 线

请 Cline 安装 BlindPay MCP 服务器 `https://github.com/blindpaylabs/blindpay-mcp`。接下来 [页:1](https://npmcn.com/package/%40blindpay/mcp/llms-install.md)。 。 。 .

### 双子座CLI

```bash
gemini extensions install https://github.com/blindpaylabs/blindpay-mcp
```

### 夹克

本地 stdio 服务器在一个容器中, 由此 repo 构建 :

```bash
docker build -t blindpay-mcp .
docker run -i --rm -e BLINDPAY_API_KEY=your-api-key-here -e BLINDPAY_INSTANCE_ID=your-instance-id-here blindpay-mcp
```

### 任何其他 MCP 客户端

远程: 指向客户端 `https://mcp.blindpay.com/mcp` (Streamable HTTP, OAuth 2.1 通过 `/.well-known/oauth-protected-resource`) (中文(简体) ). 本地: 运行 `npx -y @blindpay/mcp` 超音速飞行 `BLINDPAY_API_KEY` 设置.

## 示例提示

配置后, 您可以要求您的 AI 助手与 BlindPay 交互 :

```
"Get me a quote for sending 1000 USDC to a bank account in Brazil"

"List all my recent payouts from the last 7 days"

"Create a virtual account for the customer with ID re_xxxxxxxxxxxx"

"Show me the available payment rails"

"Get all customers for instance in_xxxxxxxxxxxx"
```

> \[TIP\] 设定 `BLINDPAY_INSTANCE_ID` 和每个实例镜像工具为您填写实例 ID, 远程服务器的方式; 模型发送的值被忽略 。 没有它,就立刻把身份证明交给你.

## 文档

-   [开始](https://blindpay.com/docs/getting-started/overview)
-   [API 参考](https://api.blindpay.com/reference)

## 支助

-   电子邮件 : [eric@blindpay.com (英语)](mailto:eric@blindpay.com)
-   问题: [GitHub 问题](https://github.com/blindpaylabs/blindpay-mcp/issues)

## 许可证

本项目根据以下规定获得许可证: [MIT 许可证](https://npmcn.com/package/%40blindpay/mcp/LICENSE) 详情见LICENSE文件.

由美国制造 [盲页](https://blindpay.com/) 团队

## 常见问题

### @blindpay/mcp 是什么？

BlindPay API官方MCP服务器 - 全球支付稳定币API

### 如何安装 @blindpay/mcp？

在项目目录运行 npm install @blindpay/mcp，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 blindpay-mcp，可以用 npx blindpay-mcp 直接运行。

### @blindpay/mcp 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @blindpay/mcp 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @blindpay/mcp 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=20\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @blindpay/mcp 可以商用吗？

@blindpay/mcp 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @blindpay/mcp 的下载量有多少？

根据 npm 官方下载统计，@blindpay/mcp 在 2026/10/09 – 2026/11/07 这 30 天内被下载 2,007 次，日均约 67 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @blindpay/mcp 还在维护吗？

最新版本 1\.10\.2 发布于 2026/11/07（1 天前）；至今共发布 24 个版本，其中过去 12 个月发布了 24 个；首次发布于 2026/01/05。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。