ZBD MCP 서버

LLM에 비트코인 권한을 추가하세요.

기본 SDK

이 MCP 서버는 공식 TypeScript SDK인 https://github.com/modelcontextprotocol/typescript-sdk 를 사용합니다.

필수 조건

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

지엑스피1

윈도우

# 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 도구를 구축하는 모듈식 접근 방식을 보여줍니다.

각 도구는 src 디렉토리의 자체 TypeScript 파일에 정의되어 있습니다.
각 도구는 bin 디렉토리의 독립 실행형 실행 파일로 빌드될 수 있습니다.
주요 index.ts 실제 툴링 구현을 제공합니다.

사용 가능한 도구

ZBD ( src/zbd.ts ): 글로벌 비트코인 라이트닝 결제를 위한 ZBD API

새로운 도구 만들기

새로운 도구를 만들려면:

src 디렉토리에 새 TypeScript 파일을 만듭니다(예: 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

커서 노트

커서와 함께 이러한 도구를 사용할 때는 항상 실행 파일의 전체 경로를 사용하세요.

/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:coverage

ZBD.ts 사용 가능한 도구

ZBD MCP 서버에서는 다음과 같은 도구를 사용할 수 있습니다.

send-lightning-payment - ZBD를 사용하여 라이트닝 주소로 비트코인 라이트닝 네트워크 결제를 보냅니다.
send-gamertag-payment - ZBD 게이머태그에 비트코인 결제 보내기
create-gamertag-charge - ZBD 사용자에 대한 지불 요청 생성
validate-lightning-address - Lightning 주소의 유효성을 확인합니다.
create-lightning-charge - Lightning 주소에 대한 결제 요청 생성
get-userid-by-gamertag - ZBD 게이머태그에서 사용자 ID 검색
get-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 - 비트코인 출금 QR 코드 생성
get-withdrawal-request - 단일 출금 요청에 대한 모든 데이터를 검색합니다.
send-payment - 비트코인 라이트닝 네트워크 결제 보내기
get-payment - 단일 결제에 대한 모든 데이터 검색
decode-charge - Charge QR 코드의 내부 속성 이해
create-charge - 새로운 비트코인 라이트닝 네트워크 요금 생성
get-charge - 단일 요금에 대한 모든 데이터 검색
create-voucher - 모든 ZBD 사용자가 사용할 수 있는 일회용 ZBD 바우처를 만듭니다.
get-voucher - ZBD 바우처에 대한 세부 정보 검색
redeem-voucher - ZBD 바우처를 사용하여 프로젝트 지갑에 크레딧을 적립하세요
revoke-voucher - 유효한 ZBD 바우처를 취소하고 프로젝트 지갑에서 sats를 회수합니다.
send-batch-lightning-payments - 단일 요청으로 여러 개의 비트코인 라이트닝 네트워크 결제를 라이트닝 주소로 보냅니다.

ZBD MCP Server

Integrations