Skip to main content
Glama
enesjakozh

Bitcoin SV MCP Server

by b-open-io
npmGitHub
TypeScript
MIT License
996
10
  • Apple
  • Linux
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

비트코인 SV MCP 서버

⚠️ 공지: 실험 작업 진행 중
이 프로젝트는 초기 실험 단계에 있습니다. 기능이 변경될 수 있으며 API는 아직 안정적이지 않습니다. 기여, 피드백, 버그 리포트를 환영합니다! 이슈를 생성하거나 풀 리퀘스트를 제출해 주세요.

모델 컨텍스트 프로토콜(MCP) 프레임워크를 위한 비트코인 SV(BSV) 도구 모음입니다. 이 라이브러리는 BSV 블록체인 상호작용을 위한 지갑, 서수, 유틸리티 함수를 제공합니다.

설치 및 설정

Bun을 사용하세요(선택 사항이지만 권장)

이 프로젝트는 빠른 JavaScript 런타임이자 패키지 관리자인 Bun을 사용하여 빌드되었습니다. 최상의 성능을 위해서는 Bun이 권장되지만, Bun은 Node.js와 하위 호환성을 갖도록 설계되었으므로 Node.js 및 npm으로도 서버를 실행할 수 있습니다.

Bun 설치

macOS(Homebrew 사용):

지엑스피1

macOS/Linux/WSL(설치 스크립트 사용):

curl -fsSL https://bun.sh/install | bash

Windows: Windows 사용자는 WSL(Windows Subsystem for Linux) 또는 Docker를 사용하여 Bun을 실행해야 합니다.

Node.js와 npm도 작동하지만 동일한 성능상의 이점을 제공하지 못할 수 있습니다.

MCP 클라이언트에 연결

이 서버는 모델 컨텍스트 프로토콜 (MCP)을 구현하여 AI 어시스턴트가 비트코인 SV 기능을 활용할 수 있도록 합니다. 이 서버를 다양한 MCP 호환 클라이언트에 연결할 수 있습니다.

MCP 구성 예

참고: PRIVATE_KEY_WIF 환경 변수는 이제 선택 사항입니다. 이 변수가 없으면 서버는 교육 자료 및 지갑 관련 도구가 아닌 제한된 모드로 실행됩니다. 지갑 및 MNEE 토큰 작업에는 유효한 개인 키가 필요합니다. IDENTITY_KEY_WIF 환경 변수를 설정하여 인증, 큐레이션 및 신뢰 웹을 위한 서수 비문의 시그마 프로토콜 서명을 활성화할 수도 있습니다.

커서

Cursor 와 함께 BSV MCP 서버를 사용하려면:

  1. 아직 Cursor를 설치하지 않았다면 설치하세요.
  2. 커서를 열고 설정 → 확장 → 모델 컨텍스트 프로토콜로 이동합니다.
  3. "새로운 글로벌 MCP 서버 추가"를 클릭하세요.
  4. 다음 구성을 JSON 형식으로 입력하세요.
{ "mcpServers": { "Bitcoin SV": { "command": "bunx", "args": [ "bsv-mcp@latest" ], "env": { "PRIVATE_KEY_WIF": "<your_private_key_wif>", "IDENTITY_KEY_WIF": "<your_identity_key_wif>" } } } }
  1. <your_private_key_wif> 실제 개인 키 WIF로 바꾸세요(보안에 유의하세요!). 개인 키 WIF가 없다면 지금은 이 부분을 해제해도 되지만, 지갑이 필요한 도구는 사용할 수 없습니다. <your_identity_key_wif> 도 선택 사항입니다. 제공된 신원 키를 사용하여 시그마 프로토콜을 통해 1Sat Ordinals에 서명합니다.
  2. "저장"을 클릭하세요

BSV 도구는 이제 "Bitcoin SV" 네임스페이스에서 Cursor의 AI 어시스턴트에서 사용할 수 있습니다.

npm 사용자를 위한 대안

Bun 대신 npm을 사용하려면:

{ "mcpServers": { "Bitcoin SV": { "command": "npx", "args": [ "bsv-mcp@latest" ], "env": { "PRIVATE_KEY_WIF": "<your_private_key_wif>", "IDENTITY_KEY_WIF": "<your_identity_key_wif>" } } } }

데스크톱용 클로드

이 서버를 데스크톱용 Claude에 연결하려면:

  1. 데스크톱용 Claude를 열고 Claude > 설정 > 개발자로 이동하세요.
  2. "구성 편집"을 클릭하세요.

선호하는 텍스트 편집기에서 Claude 구성 JSON 파일을 엽니다. CLI에서 작업하는 것을 선호한다면 다음을 수행합니다.

# macOS/Linux code ~/Library/Application\ Support/Claude/claude_desktop_config.json # Windows code %APPDATA%\Claude\claude_desktop_config.json
  1. 구성에 BSV MCP 서버를 추가합니다.
    { "mcpServers": { "Bitcoin SV": { "command": "bun", "args": [ "run", "bsv-mcp@latest" ], "env": { "PRIVATE_KEY_WIF": "<your_private_key_wif>", "IDENTITY_KEY_WIF": "<your_identity_key_wif>" } } } }
  2. <your_private_key_wif> 실제 개인 키 WIF로 바꾸세요.
  3. 파일을 저장하고 Claude for Desktop을 다시 시작하세요.
  4. Claude for Desktop에서 도구 아이콘(망치)을 클릭하면 BSV 도구가 나타납니다.
npm 사용자를 위한 대안(Claude)

Bun 대신 npm을 사용하려면 "command" 필드를 "npx"로 바꾸세요.

사용 가능한 도구

툴킷은 여러 카테고리로 구성되어 있습니다.

지갑 도구

지갑 도구는 핵심 BSV 지갑 기능을 제공합니다.

도구 이름설명출력 예
wallet_getPublicKey지정된 프로토콜과 키 ID에 대한 공개 키를 검색합니다.{"publicKey":"032d0c73eb9270e9e009fd1f9dd77e19cf764fbad5f799560c4e8fd414e40d6fc2"}
wallet_createSignature제공된 데이터에 대한 암호화 서명을 생성합니다.{"signature":[144,124,85,193,226,45,140,249,9,177,11,167,33,215,209,38,...]}
wallet_verifySignature제공된 데이터에 대해 암호화 서명을 확인합니다.{"isValid":true}
wallet_encryption지갑의 암호화 키를 사용하여 데이터를 암호화하고 복호화하는 통합 도구입니다. 예: 1. 텍스트 암호화: "Encrypt this message: Hello World" 2. 데이터 복호화: "Decrypt this data that was previously encrypted for me"암호화: {"ciphertext":[89,32,155,38,125,22,49,226,26,...]} 복호화: {"plaintext":"hello world"}
wallet_getAddress현재 지갑 또는 파생 경로에 대한 BSV 주소를 반환합니다.{"address":"1ExampleBsvAddressXXXXXXXXXXXXXXXXX","status":"ok"}
wallet_sendToAddress지정된 주소로 BSV를 전송합니다(BSV 또는 USD 금액 지원){"status":"success","txid":"a1b2c3d4e5f6...","satoshis":1000000}
wallet_purchaseListing마켓플레이스 목록에서 NFT 또는 BSV-20/BSV-21 토큰을 구매합니다.{"status":"success","txid":"a1b2c3d4e5f6...","type":"nft","origin":"abcdef123456..."}
wallet_createOrdinalsBSV 블록체인에 순서를 생성하고 기록합니다.{"txid":"a1b2c3d4e5f6...","inscriptionAddress":"1ExampleAddress...","contentType":"image/png"}

BSV 도구

BSV 블록체인 및 네트워크와 상호 작용하기 위한 도구:

도구 이름설명출력 예
bsv_getPrice거래소 API에서 현재 BSV 가격을 가져옵니다.Current BSV price: $38.75 USD
bsv_decodeTransactionBSV 트랜잭션을 디코딩하고 자세한 정보를 반환합니다.{"txid":"a1b2c3d4e5f6...","version":1,"locktime":0,"size":225,"inputs":[...],"outputs":[...]}
bsv_exploreWhatsOnChain API 엔드포인트에 액세스하는 포괄적인 블록체인 탐색기 도구{"chain_info":{"chain":"main","blocks":826458,"headers":826458,"bestblockhash":"0000000000..."}}

순서형 도구

BSV에서 순서형(NFT) 작업을 위한 도구:

도구 이름설명출력 예
ordinals_getInscription특정 비문에 대한 자세한 정보를 검색합니다.{"id":"a1b2c3d4e5f6...","origin":"a1b2c3d4e5f6...","contentType":"image/png","content":"iVBORw0KGgoAAA..."}
ordinals_searchInscriptions다양한 기준에 따른 비문 검색{"results":[{"id":"a1b2c3...","contentType":"image/png","owner":"1Example..."},...]}
ordinals_marketListings통합 인터페이스를 통해 NFT, BSV-20 및 BSV-21 토큰에 대한 시장 목록을 검색합니다.{"results":[{"txid":"a1b2c3...","price":9990000,"tick":"PEPE","listing":true},...]}
ordinals_marketSalesBSV-20 및 BSV-21 토큰 시장 판매에 대한 정보를 얻습니다.{"results":[{"txid":"a1b2c3...","price":34710050,"tick":"$BTC","sale":true},...]}
ordinals_getTokenByIdOrTickerID로 특정 BSV20 토큰에 대한 세부 정보를 검색합니다.{"tick":"PEPE","max":"21000000","lim":"1000","dec":"2"}

유틸리티 도구

일반 용도 유틸리티 함수:

도구 이름설명출력 예
utils_convertData다양한 인코딩 형식(utf8, hex, base64, binary) 간에 데이터를 변환합니다. 매개 변수: - data (필수): 변환할 문자열 - from (필수): 소스 인코딩 형식(utf8, hex, base64 또는 이진수) - to (필수): 대상 인코딩 형식(utf8, hex, base64 또는 이진수) 예: - UTF-8에서 hex로: {"data": "hello world", "from": "utf8", "to": "hex"} → 68656c6c6f20776f726c64 - UTF-8에서 base64로: {"data": "Hello World", "from": "utf8", "to": "base64"} → SGVsbG8gV29ybGQ= - base64에서 UTF-8로: {"data": "SGVsbG8gV29ybGQ=", "from": "base64", "to": "utf8"} → Hello World - 16진수에서 base64로: {"data": "68656c6c6f20776f726c64", "from": "hex", "to": "base64"} → aGVsbG8gd29ybGQ= 참고: - 모든 매개변수가 필요합니다. - 도구는 변환된 데이터를 문자열로 반환합니다. - 이진 변환의 경우 데이터는 바이트 값의 배열로 표현됩니다."SGVsbG8gV29ybGQ=" (UTF-8 "Hello World"를 base64로 변환)

MNEE 도구

MNEE 토큰 작업을 위한 도구:

도구 이름설명출력 예
mnee_getBalance지갑의 현재 MNEE 토큰 잔액을 검색합니다.{"balance": {"amount": 2900, "decimalAmount": 0.029}}
mnee_sendMnee지정된 주소로 MNEE 토큰을 보내세요. MNEE 및 USD 금액을 모두 지원합니다.{"success": true, "txid": "d1ce853934964e6c1fe9f44c918a824f175c6ab466b966f49ebc0682a8318895", "rawtx": "0100000002a0be40d8942015f1...", "mneeAmount": 0.01, "usdAmount": "$0.01", "recipient": "15mNxEkyKJXPD8amic6oLUjS45zBKQQoLu"}
mnee_parseTxMNEE 거래를 파싱하여 해당 거래 내역 및 금액에 대한 자세한 정보를 얻습니다. 모든 금액은 소수점 이하 5자리까지 표시되는 원자 단위(예: 1000 원자 단위 = 0.01 MNEE)입니다.{"txid": "d1ce853934964e6c1fe9f44c918a824f175c6ab466b966f49ebc0682a8318895", "environment": "production", "type": "transfer", "inputs": [{"address": "18izL7Wtm2fx3ALoRY3MkY2VFSMjArP62D", "amount": 2900}], "outputs": [{"address": "15mNxEkyKJXPD8amic6oLUjS45zBKQQoLu", "amount": 1000}, {"address": "19Vq2TV8aVhFNLQkhDMdnEQ7zT96x6F3PK", "amount": 100}, {"address": "18izL7Wtm2fx3ALoRY3MkY2VFSMjArP62D", "amount": 1800}]}

MCP와 함께 도구 사용

연결되면 AI 비서를 통해 자연어를 사용하여 Bitcoin SV와 상호 작용할 수 있습니다. 다음은 몇 가지 프롬프트 예시입니다.

지갑 운영

  • "내 비트코인 SV 주소를 받아보세요"
  • "0.01 BSV를 1ExampleBsvAddressXXXXXXXXXXXXXXXXX로 전송"
  • "1ExampleBsvAddressXXXXXXXXXXXXXXXXX로 5달러 상당의 BSV를 보내세요"
  • "0.01 MNEE를 1ExampleBsvAddressXXXXXXXXXXXXXXXXX로 전송"
  • "내 MNEE 잔액을 확인하세요"
  • "이 MNEE 거래를 구문 분석하세요: txid"
  • "내 지갑 키를 사용하여 이 메시지를 암호화합니다"
  • "이전에 나를 위해 암호화된 데이터를 해독해 주세요"
  • "이 NFT 목록을 구매하세요: txid_vout"
  • "이 BSV-20 토큰 목록을 구매하세요: txid_vout"

순서형(NFT)

  • "아웃포인트 6a89047af2cfac96da17d51ae8eb62c5f1d982be2bc4ba0d0cd2084b7ffed325_0을 사용하여 NFT에 대한 정보를 보여주세요"
  • "픽셀 조이드 NFT를 검색하세요"
  • "BSV NFT에 대한 현재 마켓플레이스 목록을 보여주세요"
  • "PEPE 티커에 대한 BSV-20 토큰 목록을 보여주세요"
  • "최근 BSV-20 토큰 판매 내역을 확인하세요"

블록체인 운영

  • "현재 BSV 가격은 얼마인가요?"
  • "이 BSV 트랜잭션을 디코딩하세요: (트랜잭션 16진수 또는 ID)"
  • "최신 비트코인 SV 체인 정보를 받아보세요"
  • "높이 800000에 대한 블록 세부 정보를 보여주세요"
  • "주소 1ExampleBsvAddressXXXX에 대한 거래 내역을 탐색하세요"
  • "내 지갑 주소에 대한 사용되지 않은 출력(UTXO)을 확인하세요"
  • "해시 a1b2c3d4e5f6를 사용하여 거래에 대한 세부 정보를 얻으세요..."

데이터 변환

  • "UTF-8에서 16진수 형식으로 'Hello World'를 변환합니다"

MCP 프롬프트 및 리소스

BSV MCP 서버는 비트코인 SV 기술에 대한 자세한 정보와 맥락을 제공하는 특수 프롬프트와 리소스를 제공합니다. AI 모델은 이러한 정보에 접근하여 이해도와 역량을 향상시킬 수 있습니다.

사용 가능한 프롬프트

서버는 MCP 프로토콜을 통해 직접 액세스할 수 있는 다음과 같은 교육 프롬프트를 제공합니다.

순서형 프롬프트
  • 식별자 : bitcoin_sv_ordinals
  • 설명 : Bitcoin SV 순서수에 대한 포괄적인 정보로, 순서수가 무엇인지, 어떻게 작동하는지, 어떻게 사용하는지 등이 나와 있습니다.
  • 사용법 : 이 정보에 접근하려면 도우미에게 "Bitcoin SV ordinals" 또는 "1Sat Ordinals"에 대해 물어보세요.
BSV SDK 프롬프트

Bitcoin SV SDK에 대한 자세한 정보를 제공하는 프롬프트 모음:

  • 개요
    • 식별자 : bitcoin_sv_sdk_overview
    • 설명 : Bitcoin SV SDK의 일반적인 개요, 목적 및 주요 구성 요소 포함.
    • 사용법 : "BSV SDK에 대해 알려주세요" 또는 "Bitcoin SV SDK가 무엇인가요?"
  • 지갑 운영
    • 식별자 : bitcoin_sv_sdk_wallet
    • 설명 : BSV SDK의 지갑 작업에 대한 정보입니다.
    • 사용법 : "BSV SDK에서 지갑 작업은 어떻게 작동합니까?"
  • 거래 빌딩
    • 식별자 : bitcoin_sv_sdk_transaction
    • 설명 : 거래 생성 및 조작에 대한 세부 정보입니다.
    • 사용법 : "BSV SDK 트랜잭션 빌드에 대해 설명하세요" 또는 "BSV SDK로 트랜잭션을 어떻게 생성하나요?"
  • 입증
    • 식별자 : bitcoin_sv_sdk_auth
    • 설명 : BSV SDK의 인증 및 ID 프로토콜.
    • 사용법 : "BSV SDK를 사용하면 인증이 어떻게 작동합니까?"
  • 암호화
    • 식별자 : bitcoin_sv_sdk_cryptography
    • 설명 : 서명, 암호화, 검증 기능.
    • 사용법 : "BSV SDK 암호화 기능 설명"
  • 스크립팅
    • 식별자 : bitcoin_sv_sdk_script
    • 설명 : 비트코인 스크립팅 및 계약 기능.
    • 사용법 : "BSV SDK를 사용하여 비트코인 스크립트를 어떻게 사용합니까?"
  • 원시
    • 식별자 : bitcoin_sv_sdk_primitives
    • 설명 : BSV SDK의 핵심 데이터 유형 및 구조.
    • 사용법 : "BSV SDK에서 사용할 수 있는 기본 요소는 무엇입니까?"

사용 가능한 리소스

이 서버는 또한 Bitcoin Request for Comments(BRC) 사양 및 문서에 대한 액세스를 제공합니다.

변경 로그 리소스
  • 식별자 : bsv-mcp-changelog
  • 설명 : BSV MCP 서버의 버전 기록 및 변경 로그입니다.
  • 사용법 : "BSV MCP 변경 사항을 보여주세요" 또는 "최신 버전의 새로운 기능은 무엇인가요?"
BRC 리소스
  • BRC 개요
    • 식별자 : brcs_readme
    • 설명 : BRC 저장소에 있는 모든 Bitcoin SV 프로토콜 사양에 대한 개요입니다.
    • 사용법 : "Bitcoin SV BRC 개요 보기"
  • BRC 요약
    • 식별자 : brcs_summary
    • 설명 : 모든 Bitcoin SV BRC에 대한 목차입니다.
    • 사용법 : "Bitcoin SV BRC에 대한 요약을 알려주세요"
  • 특정 BRC 사양
    • 식별자 : brc_spec
    • 설명 : 범주 및 번호별로 특정 BRC 사양에 접근합니다.
    • 사용법 : "거래 봉투에 BRC 8을 표시해 주세요" 또는 "BRC 1은 무엇을 지정합니까?"
BRC 카테고리

BRC 사양은 다음 범주로 구성됩니다.

  • 지갑
  • 업무
  • 스크립트
  • 토큰
  • 오버레이
  • 결제
  • 피어투피어
  • 키 유도
  • 아웃포인트
  • 의견
  • 상태 머신
  • 앱

프롬프트 및 리소스 사용

AI 모델은 이러한 프롬프트와 리소스를 사용하여 비트코인 SV 기술에 대해 더욱 정확하고 자세한 답변을 제공할 수 있습니다. 사용자는 다음을 수행할 수 있습니다.

  1. 특정 주제에 대해 질문하세요 : "Bitcoin SV 순서수에 대해 알려주세요" 또는 "BSV SDK 거래 구성에 대해 설명해 주세요"
  2. 특정 BRC 세부 정보 요청 : "BRC 8은 무엇을 지정합니까?" 또는 "거래 생성 시 BRC 표시"
  3. 일반적인 개요 보기 : "BSV SDK란 무엇입니까?" 또는 "모든 BRC 요약 보기"

이러한 프롬프트와 리소스는 AI의 지식 기반을 강화하여 복잡한 Bitcoin SV 주제에 대해서도 보다 기술적이고 정확한 응답을 가능하게 합니다.

MCP 작동 방식

MCP 지원 AI 어시스턴트와 상호 작용하는 경우:

  1. AI는 귀하의 요청을 분석하고 어떤 도구를 사용할지 결정합니다.
  2. 귀하의 승인 하에 적절한 BSV MCP 도구가 호출됩니다.
  3. 서버는 Bitcoin SV 블록체인에서 요청된 작업을 실행합니다.
  4. 결과는 AI 어시스턴트에게 반환됩니다.
  5. 보조자는 자연스럽고 대화적인 방식으로 정보를 제공합니다.

사용자 정의 옵션

BSV MCP 서버는 환경 변수를 사용하여 사용자 정의하여 특정 구성 요소를 활성화하거나 비활성화할 수 있습니다.

구성 요소 구성

환경 변수기본설명
DISABLE_PROMPTSfalse모든 교육적 메시지를 비활성화하려면 true 로 설정합니다.
DISABLE_RESOURCESfalse모든 리소스(BRC, 변경 로그)를 비활성화하려면 true 로 설정합니다.
DISABLE_TOOLSfalse모든 도구를 비활성화하려면 true 로 설정합니다.

도구별 구성

환경 변수기본설명
DISABLE_WALLET_TOOLSfalse비트코인 지갑 도구를 비활성화하려면 true 로 설정하세요.
DISABLE_MNEE_TOOLSfalseMNEE 토큰 도구를 비활성화하려면 true 로 설정하세요.
DISABLE_BSV_TOOLSfalseBSV 블록체인 도구를 비활성화하려면 true 로 설정하세요.
DISABLE_ORDINALS_TOOLSfalseOrdinals/NFT 도구를 비활성화하려면 true 로 설정합니다.
DISABLE_UTILS_TOOLSfalse유틸리티 도구를 비활성화하려면 true 로 설정합니다.
IDENTITY_KEY_WIFnot set신원 키에 대한 선택적 WIF입니다. 설정된 경우, 순서형 비문은 인증, 큐레이션 및 신뢰 웹을 위해 시그마 프로토콜로 서명됩니다.
DISABLE_BROADCASTINGfalse트랜잭션 브로드캐스팅을 비활성화하려면 true 로 설정합니다. 대신 원시 트랜잭션 16진수를 반환합니다. 브로드캐스팅 전 테스트 및 트랜잭션 검토에 유용합니다.

예시

도구 없이 교육 자료와 프롬프트만 사용하여 실행하세요.

DISABLE_TOOLS=true bunx bsv-mcp@latest

BSV 도구만 사용하여 실행하고 지갑이나 다른 기능은 사용하지 않습니다.

DISABLE_PROMPTS=true DISABLE_RESOURCES=true DISABLE_WALLET_TOOLS=true DISABLE_MNEE_TOOLS=true DISABLE_ORDINALS_TOOLS=true DISABLE_UTILS_TOOLS=true bunx bsv-mcp@latest

지갑 작업을 제외한 모든 도구를 사용하세요:

DISABLE_WALLET_TOOLS=true bunx bsv-mcp@latest

브로드캐스트하지 않고 거래 생성(테스트 실행 모드):

DISABLE_BROADCASTING=true bunx bsv-mcp@latest

문제 해결

BSV MCP 서버에 문제가 있는 경우:

연결 문제

  1. 시스템에 Bun 또는 Node.js가 설치되어 있는지 확인하세요.
  2. WIF 개인 키가 환경에 올바르게 설정되었는지 확인하세요.
  3. 클라이언트가 MCP를 지원하고 올바르게 구성되었는지 확인하세요.
  4. 클라이언트 콘솔 출력에서 오류 메시지를 찾으세요.

Bun을 최신 상태로 유지하기

호환성을 보장하려면 Bun을 최신 버전으로 업데이트하는 것이 중요합니다.

# Update Bun to the latest version bun upgrade

현재 Bun 버전을 확인하려면:

bun --version

로깅 및 디버깅

데스크톱용 Claude의 경우 다음에서 로그를 확인하세요.

# macOS/Linux tail -n 20 -f ~/Library/Logs/Claude/mcp*.log # Windows type %APPDATA%\Claude\Logs\mcp*.log

커서의 경우 설정 → 확장 → 모델 컨텍스트 프로토콜에서 커서 MCP 로그를 확인하세요.

최근 업데이트

  • 거래 브로드캐스트 제어 : 거래가 네트워크로 브로드캐스트되는 것을 방지하기 위해 DISABLE_BROADCASTING 환경 변수가 추가되었습니다.
  • 블록체인 탐색기 : 메인넷/테스트넷 지원을 통해 WhatsOnChain API 액세스를 위한 bsv_explore 도구가 추가되었습니다.
  • 통합 도구 : wallet_encrypt / wallet_decrypt 단일 wallet_encryption 도구로 통합
  • 향상된 마켓플레이스 : 상장, 판매 및 구매에서 NFT, BSV-20/21 토큰 지원
  • 성능 : 가격 캐싱 추가 및 API 엔드포인트 구조 최적화
  • 개선된 유효성 검사 : 개인 키 및 매개변수에 대한 더 나은 오류 처리

비트코인 SV 블록체인 탐색기

bsv_explore 도구는 WhatsOnChain API를 통해 비트코인 SV 블록체인에 대한 포괄적인 접근을 제공합니다. 이 강력한 탐색기 도구를 사용하면 체인 데이터, 블록, 거래 내역, 주소 정보 등 블록체인의 다양한 측면을 조회할 수 있습니다.

사용 가능한 엔드포인트

이 도구는 다음과 같은 엔드포인트 범주와 특정 엔드포인트를 지원합니다.

체인 데이터
엔드포인트설명필수 매개변수예시 응답
chain_info네트워크 통계, 난이도 및 체인 작업없음{"chain":"main","blocks":826458,"headers":826458,"bestblockhash":"0000000000..."}
chain_tips높이와 상태를 포함한 현재 체인 팁없음[{"height":826458,"hash":"000000000000...","branchlen":0,"status":"active"}]
circulating_supply현재 BSV 순환 공급량없음{"bsv":21000000}
peer_info연결된 피어 통계없음[{"addr":"1.2.3.4:8333","services":"000000000000...","lastsend":1621234567}]
블록 데이터
엔드포인트설명필수 매개변수예시 응답
block_by_hash해시를 통한 완전한 블록 데이터blockHash{"hash":"000000000000...","confirmations":1000,"size":1000000,...}
block_by_height높이를 통한 완전한 블록 데이터blockHeight{"hash":"000000000000...","confirmations":1000,"size":1000000,...}
tag_count_by_height특정 블록의 태그 수에 대한 통계blockHeight{"tags":{"amp":3,"bitkey":5,"metanet":12,"planaria":7,"b":120}}
block_headers마지막 10개 블록 헤더를 검색합니다.없음[{"hash":"000000000000...","height":826458,"version":536870912,...},...]
block_pages대규모 블록에 대한 거래 ID 페이지를 검색합니다.blockHash , 선택 사항: pageNumber["tx1hash","tx2hash","tx3hash",...]
통계 데이터
엔드포인트설명필수 매개변수예시 응답
block_stats_by_height특정 높이에 대한 블록 통계blockHeight{"size":123456,"txCount":512,"outputTotal":54.12345678,"outputTotalUsd":2345.67,...}
block_miner_stats특정 기간 동안의 블록 마이닝 통계선택 사항: days (기본값 7){"blocks":{"miner1":412,"miner2":208,...},"total":1008}
miner_summary_stats광산 통계 요약선택 사항: days (기본값 7){"totalBlocks":1008,"totalFees":1.23456789,"totalFeesUsd":53.67,...}
거래 데이터
엔드포인트설명필수 매개변수예시 응답
tx_by_hash자세한 거래 데이터txHash{"txid":"a1b2c3d4e5f6...","version":1,"locktime":0,"size":225,...}
tx_raw원시 거래 16진수 데이터txHash"01000000012345abcdef..."
tx_receipt거래 영수증txHash{"blockHash":"000000000000...","blockHeight":800000,"confirmations":26458}
bulk_tx_details한 번의 요청으로 여러 거래 검색txids (배열)[{"txid":"a1b2c3d4e5f6...","version":1,...}, {"txid":"b2c3d4e5f6a7...","version":1,...}]
주소 데이터
엔드포인트설명필수 매개변수예시 응답
address_history주소별 거래 내역address , 선택 사항: limit[{"tx_hash":"a1b2c3d4e5f6...","height":800000},...]
address_utxos주소에 대한 사용되지 않은 출력address[{"tx_hash":"a1b2c3d4e5f6...","tx_pos":0,"value":100000},...]
회로망
엔드포인트설명필수 매개변수예시 응답
healthAPI 상태 점검없음{"status":"synced"}

사용 예

bsv_explore 도구는 다음과 같은 자연어 프롬프트와 함께 사용할 수 있습니다.

"Get the current Bitcoin SV blockchain information" "Show me block #800000 details" "Get tag count statistics for block #800000" "Fetch transaction history for address 1ExampleBsvAddressXXXXXXXX" "Get unspent outputs for my wallet address" "Check transaction details for txid a1b2c3d4e5f6..." "What is the current BSV circulating supply?" "Show me the latest block headers" "Get transaction IDs for page 2 of a large block" "Show me block statistics for height 800000" "What are the mining statistics for the last 14 days?" "Get a summary of mining activity over the past 30 days" "Retrieve details for multiple transactions in a single query"

도구의 내부적으로는 어떤 데이터를 검색할지 지정하는 매개변수를 허용합니다.

  • endpoint : 쿼리할 특정 WhatsOnChain 엔드포인트(예: chain_info , tx_by_hash )
  • network : 사용할 BSV 네트워크( main 또는 test )
  • 특정 엔드포인트에 필요한 추가 매개변수:
    • blockHash : block_by_hash 및 block_pages 엔드포인트용
    • blockHeight : block_by_height, tag_count_by_height 및 block_stats_by_height 엔드포인트의 경우
    • pageNumber : block_pages 엔드포인트(페이지 매김)용
    • days : block_miner_stats 및 miner_summary_stats 엔드포인트의 경우(기본값은 7)
    • txHash : 거래 관련 엔드포인트(tx_by_hash, tx_raw, tx_receipt)
    • txids : bulk_tx_details 엔드포인트(트랜잭션 ID 배열)
    • address : 주소 관련 엔드포인트의 경우
    • limit : address_history에 대한 선택적 페이지 매김 제한

네트워크 옵션

이 도구는 메인넷과 테스트넷을 모두 지원합니다.

  • main : 비트코인 SV 메인넷(기본)
  • test : 비트코인 SV 테스트넷

개발

프로젝트 설정

프로젝트에 기여하거나 로컬로 실행하고 싶다면:

  1. 저장소를 복제합니다.
    git clone https://github.com/b-open-io/bsv-mcp.git cd bsv-mcp
  2. 종속성 설치:
    bun install # or with npm npm install

서버 실행

bun run index.ts # or with npm npm run start

테스트 실행

bun test # or with npm npm test

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

Install Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

View all tools

AI 어시스턴트가 지갑 작업, 순서형(NFT) 및 다양한 블록체인 유틸리티를 통해 BSV 블록체인과 상호 작용할 수 있도록 하는 모델 컨텍스트 프로토콜을 위한 Bitcoin SV 도구 모음입니다.

  1. 설치 및 설정
    1. Bun을 사용하세요(선택 사항이지만 권장)
  2. MCP 클라이언트에 연결
    1. 커서
    2. 데스크톱용 클로드
  3. 사용 가능한 도구
    1. 지갑 도구
    2. BSV 도구
    3. 순서형 도구
    4. 유틸리티 도구
    5. MNEE 도구
  4. MCP와 함께 도구 사용
    1. 지갑 운영
    2. 순서형(NFT)
    3. 블록체인 운영
    4. 데이터 변환
  5. MCP 프롬프트 및 리소스
    1. 사용 가능한 프롬프트
    2. 사용 가능한 리소스
    3. 프롬프트 및 리소스 사용
  6. MCP 작동 방식
    1. 사용자 정의 옵션
      1. 구성 요소 구성
      2. 도구별 구성
      3. 예시
    2. 문제 해결
      1. 연결 문제
      2. Bun을 최신 상태로 유지하기
      3. 로깅 및 디버깅
    3. 최근 업데이트
      1. 비트코인 SV 블록체인 탐색기
        1. 사용 가능한 엔드포인트
        2. 사용 예
        3. 네트워크 옵션
      2. 개발
        1. 프로젝트 설정
        2. 서버 실행
        3. 특허

      Related MCP Servers

      • Flow MCP Server

        lmcmz
        -
        security
        F
        license
        -
        quality
        A Model Context Protocol server that enables AI assistants to access Flow blockchain data and perform operations such as checking balances, resolving domains, executing scripts, and submitting transactions.
        Last updated -
        JavaScript
        • Linux
        • Apple

      • Bankless Onchain MCP Serverofficial

        Bankless
        A
        security
        F
        license
        A
        quality
        Implements the Model Context Protocol to allow AI models to access and interact with blockchain data, including reading contract states, retrieving events, and accessing transaction information across various networks.
        Last updated -
        10
        45
        30
        TypeScript

      • Chronos MCP Server

        grandmastr
        -
        security
        A
        license
        -
        quality
        A Model Context Protocol server for integrating AI assistants like Claude Desktop with the Stellar blockchain, enabling wallet connections, token listings, balance queries, and fund transfers.
        Last updated -
        5
        JavaScript
        MIT License
        • Apple
        • Linux

      • SVM-MCP

        rkmonarch
        -
        security
        F
        license
        -
        quality
        A Model Context Protocol server that connects Claude AI with SOON and other SVM-based blockchains, allowing users to check account balances, fetch recent transactions, and view token holdings on SOON's testnet and mainnet.
        Last updated -
        1
        JavaScript

      View all related MCP servers

      New MCP Servers

      MCP directory API

      We provide all the information about MCP servers via our MCP API.

      curl -X GET 'https://glama.ai/api/mcp/v1/servers/b-open-io/bsv-mcp'

      If you have feedback or need assistance with the MCP directory API, please join our Discord server