⚠️ 弃用通知
🚨 此MCP服务器不再维护。 🚨
我们已经转向了新的和改进的MCP服务器实现。所有未来的更新、功能和支持都将在那里提供。
👉 请在此处迁移到新的MCP服务器：https://github.com/zebedeeio/zbd-payments-typescript-sdk/tree/main/packages/mcp-server
此仓库仍将可供参考，但不建议用于生产。
______________________________________________________________________
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
先决条件
- Node.js 23+（或Bun/Deno/任何支持运行.ts文件的东西）
- Bun（用于构建可执行文件）
- 用于支付处理的ZBD API密钥
ZBD设置
从ZBD开发人员仪表板获取API密钥，并将其放入新的 .env 文件下 ZBD_API_KEY=XXXXXXXXXXXX （检查 .env.example 例如）。
一旦完成，运行 pnpm build 命令并在您的客户端上设置MCP服务器（例如Claude Desktop或Cursor）。
安装Bun
如果您没有安装Bun，可以使用以下方法之一进行安装：
macOS和Linux
# Using curl (recommended)
curl -fsSL https://bun.sh/install | bash
# Using Homebrew
brew install oven-sh/bun/bun
# Using npm
npm install -g bun视窗
# Using PowerShell
powershell -c "irm bun.sh/install.ps1|iex"
# Using npm
npm install -g bun
# Using Scoop
scoop install bun通过运行以下命令验证您的安装：
bun --version安装
pnpm install故障排除
- 使用
ps aux | grep mcp-zbd | grep -v grep列出所有正在运行的ZBD MCP服务器实例。 - 使用
pkill -f mcp-zbd以杀死可能残留的任何重复的ZBD MCP服务器实例。
项目结构
该项目展示了构建MCP工具的模块化方法：
- 每个工具都在它自己的TypeScript文件中定义
src目录 - 每个工具都可以内置到
bin目录 - 主要
index.ts提供实际的工具实现
可用工具
- 震旦系 (
src/zbd.ts)：ZBD API用于全球比特币闪电支付
创建新工具
要创建新工具，请执行以下操作：
- 在中创建一个新的TypeScript文件
src目录（例如。，src/mytool.ts) - 使用现有工具作为模板
- 将构建脚本添加到
package.json:
"build:mytool": "mkdir -p bin && bun build src/mytool.ts --compile --minify --sourcemap --outfile bin/mcp-mytool"- 更新
build:all包含新工具的脚本
用法
构建可执行文件
# Build all tools
pnpm build
# Build a specific tool
pnpm build:zbd生成的可执行文件将位于 bin 目录，可以直接运行：
./bin/mcp-zbd光标注释
将这些工具与Cursor一起使用时，请始终使用可执行文件的完整路径：
/path/to/your/project/bin/mcp-zbd或者，您可以直接使用Node运行TypeScript文件：
/path/to/node ~/path/to/project/src/index.ts测试
# Run all tests
pnpm test
# Run tests in watch mode
pnpm test:watch
# Run tests with coverage
pnpm test:coverageZBD.ts工具可用
ZBD MCP服务器中提供以下工具：
send-lightning-payment-使用ZBD将比特币闪电网络付款发送到闪电地址send-gamertag-payment-向ZBD玩家代号发送比特币付款create-gamertag-charge-为ZBD用户生成付款请求validate-lightning-address-验证Lightning地址的有效性create-lightning-charge-生成闪电地址的付款请求get-userid-by-gamertag-从ZBD玩家代号中检索用户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-了解Charge二维码的内部属性create-charge-创建新的比特币闪电网络费用get-charge-检索单个费用的所有数据create-voucher-创建可由任何ZBD用户兑换的一次性ZBD代金券get-voucher-检索ZBD凭证的详细信息redeem-voucher-兑换ZBD代金券，记入您的Project钱包revoke-voucher-撤销有效的ZBD凭证，并将sats退还到您的Project钱包send-batch-lightning-payments-在单个请求中向闪电地址发送多个比特币闪电网络付款
