⚠️ 사용 중단 공지

🚨 이 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 를 사용합니다.

Related MCP server: Alby Bitcoin Payments 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

지엑스피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 실제 툴링 구현을 제공합니다.

사용 가능한 도구

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

새로운 도구 만들기

새로운 도구를 만들려면:

1. src 디렉토리에 새 TypeScript 파일을 만듭니다(예: src/mytool.ts ).

2. 기존 도구를 템플릿으로 사용하세요

3. package.json 에 빌드 스크립트를 추가합니다.

"build:mytool": "mkdir -p bin && bun build src/mytool.ts --compile --minify --sourcemap --outfile bin/mcp-mytool"

4. 새 도구를 포함하도록 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 서버에서는 다음과 같은 도구를 사용할 수 있습니다.

1. send-lightning-payment - ZBD를 사용하여 라이트닝 주소로 비트코인 라이트닝 네트워크 결제를 보냅니다.

2. send-gamertag-payment - ZBD 게이머태그에 비트코인 결제 보내기

3. create-gamertag-charge - ZBD 사용자에 대한 지불 요청 생성

4. validate-lightning-address - Lightning 주소의 유효성을 확인합니다.

5. create-lightning-charge - Lightning 주소에 대한 결제 요청 생성

6. get-userid-by-gamertag - ZBD 게이머태그에서 사용자 ID 검색

7. get-gamertag-by-userid - 사용자 ID에서 ZBD 게이머태그 검색

8. send-email-payment - 모든 이메일로 즉시 비트코인 지불을 보내세요

9. get-wallet-info - ZBD 프로젝트의 지갑에 대한 모든 데이터를 검색합니다.

10. check-supported-region - 사용자가 지원되는 지역에서 왔는지 확인합니다.

11. get-zbd-ip-addresses - ZBD 서버의 공식 IP 주소를 가져옵니다.

12. internal-transfer - 두 프로젝트 간 자금 이체를 수행합니다.

13. create-withdrawal-request - 비트코인 출금 QR 코드 생성

14. get-withdrawal-request - 단일 출금 요청에 대한 모든 데이터를 검색합니다.

15. send-payment - 비트코인 라이트닝 네트워크 결제 보내기

16. get-payment - 단일 결제에 대한 모든 데이터 검색

17. decode-charge - Charge QR 코드의 내부 속성 이해

18. create-charge - 새로운 비트코인 라이트닝 네트워크 요금 생성

19. get-charge - 단일 요금에 대한 모든 데이터 검색

20. create-voucher - 모든 ZBD 사용자가 사용할 수 있는 일회용 ZBD 바우처를 만듭니다.

21. get-voucher - ZBD 바우처에 대한 세부 정보 검색

22. redeem-voucher - ZBD 바우처를 사용하여 프로젝트 지갑에 크레딧을 적립하세요

23. revoke-voucher - 유효한 ZBD 바우처를 취소하고 프로젝트 지갑에서 sats를 회수합니다.

24. send-batch-lightning-payments - 단일 요청으로 여러 개의 비트코인 라이트닝 네트워크 결제를 라이트닝 주소로 보냅니다.