⚠️ 弃用通知
🚨 此 MCP 服务器不再维护。🚨
我们已迁移至全新改进的 MCP 服务器版本。所有后续更新、功能和支持都将在此版本中提供。
👉 请在此处迁移到新的 MCP 服务器： https://github.com/zebedeeio/zbd-payments-typescript-sdk/tree/main/packages/mcp-server
该 repo 将保留供参考，但不建议用于生产用途。
ZBD MCP 服务器（已弃用 - 请改用： https ://github.com/zebedeeio/zbd-payments-typescript-sdk/tree/main/packages/mcp-server）
将比特币权力添加到您的 LLM。
基础 SDK
此 MCP 服务器使用官方 TypeScript SDK -- https://github.com/modelcontextprotocol/typescript-sdk
Related MCP server: BSC MCP Server
先决条件
Node.js 23+（或 Bun/Deno/任何支持运行 .ts 文件的版本）
Bun（用于构建可执行文件）
用于支付处理的 ZBD API 密钥
ZBD 设置
从 ZBD 开发者仪表板获取您的 API 密钥，并将其放入ZBD_API_KEY=XXXXXXXXXXXX下的新.env文件中（查看.env.example的示例）。
完成后，运行pnpm build命令并在客户端（例如 Claude Desktop 或 Cursor）上设置 MCP 服务器。
安装 Bun
如果您尚未安装 Bun，则可以使用以下方法之一进行安装：
macOS 和 Linux
视窗
通过运行以下命令验证您的安装：
安装
故障排除
使用
ps aux | grep mcp-zbd | grep -v grep列出所有正在运行的 ZBD MCP 服务器实例。使用
pkill -f mcp-zbd杀死任何可能残留的重复 ZBD MCP 服务器实例。
项目结构
该项目演示了构建 MCP 工具的模块化方法：
每个工具都在
src目录中自己的 TypeScript 文件中定义每个工具都可以构建到
bin目录中的独立可执行文件中主
index.ts提供实际的工具实现
可用工具
ZBD （
src/zbd.ts）：用于全球比特币闪电支付的 ZBD API
创建新工具
要创建新工具：
在
src目录中创建一个新的 TypeScript 文件（例如src/mytool.ts）使用现有工具作为模板
向
package.json添加构建脚本：
更新
build:all脚本以包含您的新工具
用法
构建可执行文件
生成的可执行文件将位于bin目录中，可以直接运行：
光标注释
当将这些工具与 Cursor 一起使用时，请始终使用可执行文件的完整路径：
或者，您可以直接使用 Node 运行 TypeScript 文件：
测试
ZBD.ts 工具可用
ZBD MCP 服务器中提供以下工具：
send-lightning-payment- 使用 ZBD 将比特币闪电网络付款发送到闪电地址send-gamertag-payment- 向 ZBD Gamertag 发送比特币付款create-gamertag-charge- 为 ZBD 用户生成付款请求validate-lightning-address- 验证闪电地址的有效性create-lightning-charge- 生成 Lightning 地址的付款请求get-userid-by-gamertag- 从 ZBD Gamertag 检索用户 IDget-gamertag-by-userid- 从用户 ID 检索 ZBD 玩家代号send-email-payment- 向任何电子邮件发送即时比特币付款get-wallet-info- 检索有关 ZBD 项目钱包的所有数据check-supported-region- 验证用户是否来自受支持的区域get-zbd-ip-addresses- 获取 ZBD 服务器的官方 IP 地址internal-transfer- 在两个项目之间进行资金转移create-withdrawal-request- 创建比特币提款二维码get-withdrawal-request- 检索有关单个提款请求的所有数据send-payment- 发送比特币闪电网络付款get-payment- 检索有关单笔付款的所有数据decode-charge- 了解收费二维码的内部属性create-charge- 创建新的比特币闪电网络费用get-charge- 检索有关单笔费用的所有数据create-voucher- 创建一次性使用的 ZBD 优惠券，任何 ZBD 用户都可以兑换get-voucher- 检索有关 ZBD 优惠券的详细信息redeem-voucher- 兑换 ZBD 券以存入您的项目钱包revoke-voucher- 撤销有效的 ZBD 凭证并将 Sats 回收到您的项目钱包send-batch-lightning-payments- 通过单个请求向闪电地址发送多个比特币闪电网络付款