비트코인 SV MCP 서버

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

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

MCP 클라이언트에 연결

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

커서

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

아직 Cursor를 설치하지 않았다면 설치하세요.
이 저장소를 복제하고 프로젝트 디렉토리에서 bun install 실행하세요.
커서를 열고 설정 → 확장 → 모델 컨텍스트 프로토콜로 이동합니다.
"새로운 글로벌 MCP 서버 추가"를 클릭하세요.
다음 구성을 JSON 형식으로 입력하세요.

지엑스피1

<your_private_key_wif> 실제 개인 키 WIF로 바꾸세요(보안을 철저히 유지하세요!)
"저장"을 클릭하세요

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

데스크톱용 클로드

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

Claude for Desktop이 설치되어 있고 최신 버전으로 업데이트되었는지 확인하세요.
이 저장소를 복제하고 프로젝트 디렉토리에서 bun install 실행하세요.
Claude for Desktop 구성 파일을 엽니다.
# macOS/Linux code ~/Library/Application\ Support/Claude/claude_desktop_config.json # Windows code %APPDATA%\Claude\claude_desktop_config.json
구성에 BSV MCP 서버를 추가합니다(파일이 없으면 만듭니다).
{ "mcpServers": { "Bitcoin SV": { "command": "bunx", "args": [ "bsv-mcp@latest" ], "env": { "PRIVATE_KEY_WIF": "<your_private_key_wif>" } } } }
<your_private_key_wif> 실제 개인 키 WIF로 바꾸세요.
파일을 저장하고 Claude for Desktop을 다시 시작하세요.
Claude for Desktop에서 도구 아이콘(망치)을 클릭하면 BSV 도구가 나타납니다.

사용 가능한 도구

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

지갑 도구

지갑 도구는 핵심 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_createOrdinals`	BSV 블록체인에 순서를 생성하고 기록합니다.	`{"txid":"a1b2c3d4e5f6...","inscriptionAddress":"1ExampleAddress...","contentType":"image/png"}`

BSV 도구

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

도구 이름	설명	출력 예
`bsv_getPrice`	거래소 API에서 현재 BSV 가격을 가져옵니다.	`Current BSV price: $38.75 USD`
`bsv_decodeTransaction`	BSV 트랜잭션을 디코딩하고 자세한 정보를 반환합니다.	`{"txid":"a1b2c3d4e5f6...","version":1,"locktime":0,"size":225,"inputs":[...],"outputs":[...]}`
`bsv_explore`	WhatsOnChain 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_marketSales`	BSV-20 및 BSV-21 토큰 시장 판매에 대한 정보를 얻습니다.	`{"results":[{"txid":"a1b2c3...","price":34710050,"tick":"$BTC","sale":true},...]}`
`ordinals_getTokenByIdOrTicker`	ID로 특정 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_parseTx`	MNEE 거래를 파싱하여 해당 거래 내역 및 금액에 대한 자세한 정보를 얻습니다. 모든 금액은 소수점 이하 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 작동 방식

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

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

문제 해결

서버에 연결하는 데 문제가 있는 경우:

패키지 종속성이 제대로 설치되었는지 확인하세요: bun install
WIF 개인 키가 환경에 올바르게 설정되었는지 확인하세요.
클라이언트가 MCP를 지원하고 올바르게 구성되었는지 확인하세요.
클라이언트 콘솔 출력에서 오류 메시지를 찾으세요.

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

tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

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

최근 업데이트

블록체인 탐색기 : 메인넷/테스트넷 지원을 통해 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":"000000000000..."}`
`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},...]`

회로망

엔드포인트	설명	필수 매개변수	예시 응답
`health`	API 상태 점검	없음	`{"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 테스트넷

개발

서버 실행

bun run index.ts

테스트 실행

bun test

특허

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

Bitcoin SV MCP Server

Integrations