Skip to main content
Glama
enesjakozh

Bitcoin SV MCP Server

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

Servidor MCP de Bitcoin SV

⚠️ AVISO: Trabajo experimental en progreso
Este proyecto se encuentra en una fase experimental inicial. Las características pueden cambiar y la API aún no es estable. ¡Agradecemos sus contribuciones, comentarios e informes de errores! No dude en abrir incidencias o enviar solicitudes de incorporación de cambios.

Una colección de herramientas de Bitcoin SV (BSV) para el marco del Protocolo de Contexto de Modelo (MCP). Esta biblioteca proporciona funciones de billetera, ordinales y utilidades para la interacción con la blockchain de BSV.

Instalación y configuración

Usar pan (opcional pero recomendado)

Este proyecto se creó con Bun , un entorno de ejecución rápido de JavaScript y gestor de paquetes. Si bien se recomienda Bun para un rendimiento óptimo, el servidor también puede ejecutarse con Node.js y npm, ya que Bun está diseñado para ser retrocompatible con Node.

Instalación de Bun

macOS (usando Homebrew):

brew install oven-sh/bun/bun

macOS/Linux/WSL (usando el script de instalación):

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

Windows: los usuarios de Windows deben usar WSL (Subsistema de Windows para Linux) o Docker para ejecutar Bun.

Node.js y npm también funcionarán, pero es posible que no ofrezcan los mismos beneficios de rendimiento.

Conexión a clientes MCP

Este servidor implementa el Protocolo de Contexto de Modelo (MCP), lo que permite a los asistentes de IA utilizar las funcionalidades de Bitcoin SV. Puede conectar este servidor a varios clientes compatibles con MCP.

Ejemplo de configuración de MCP

Nota: La variable de entorno PRIVATE_KEY_WIF ahora es opcional. Sin ella, el servidor funciona en modo limitado, con recursos educativos y herramientas que no son de billetera disponibles. Las operaciones con billeteras y tokens MNEE requieren una clave privada válida. También puede configurar la variable de entorno IDENTITY_KEY_WIF para habilitar la firma con protocolo sigma de inscripciones de ordinales para autenticación, curación y web de confianza.

Cursor

Para utilizar el servidor BSV MCP con Cursor :

  1. Instala Cursor si aún no lo has hecho
  2. Abra Cursor y navegue a Configuración → Extensiones → Protocolo de contexto de modelo
  3. Haga clic en "Agregar un nuevo servidor MCP global"
  4. Introduzca la siguiente configuración en formato 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. Reemplaza <your_private_key_wif> con tu clave privada WIF (¡mantenla segura!). Si no tienes una, puedes omitirla por ahora, pero no podrás usar herramientas que requieran una billetera. <your_identity_key_wif> también es opcional. Firmará los ordinales 1Sat con el protocolo Sigma usando la clave de identidad proporcionada.
  2. Haga clic en "Guardar"

Las herramientas BSV ahora estarán disponibles para el asistente de inteligencia artificial de Cursor bajo el espacio de nombres "Bitcoin SV".

Alternativa para usuarios de npm

Si prefieres usar npm en lugar de Bun:

{ "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 para escritorio

Para conectar este servidor a Claude for Desktop:

  1. Abra Claude para escritorio y vaya a Claude > Configuración > Desarrollador
  2. Haga clic en "Editar configuración".

Abra el archivo JSON de configuración de Claude en su editor de texto favorito. Si prefiere hacerlo desde la CLI:

# macOS/Linux code ~/Library/Application\ Support/Claude/claude_desktop_config.json # Windows code %APPDATA%\Claude\claude_desktop_config.json
  1. Agregue el servidor BSV MCP a su configuración:
    { "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. Reemplace <your_private_key_wif> con su clave privada WIF real
  3. Guarde el archivo y reinicie Claude for Desktop
  4. Las herramientas BSV aparecerán cuando haga clic en el ícono de herramientas (martillo) en Claude para escritorio
Alternativa para usuarios de npm (Claude)

Si prefiere utilizar npm en lugar de Bun, reemplace el campo "comando" con "npx".

Herramientas disponibles

El kit de herramientas está organizado en varias categorías:

Herramientas de billetera

Las herramientas de billetera proporcionan la funcionalidad principal de la billetera BSV:

Nombre de la herramientaDescripciónEjemplo de salida
wallet_getPublicKeyRecupera una clave pública para un protocolo y un ID de clave específicos{"publicKey":"032d0c73eb9270e9e009fd1f9dd77e19cf764fbad5f799560c4e8fd414e40d6fc2"}
wallet_createSignatureCrea una firma criptográfica para los datos proporcionados{"signature":[144,124,85,193,226,45,140,249,9,177,11,167,33,215,209,38,...]}
wallet_verifySignatureVerifica una firma criptográfica con los datos proporcionados{"isValid":true}
wallet_encryptionHerramienta combinada para cifrar y descifrar datos mediante las claves criptográficas de la billetera. Ejemplos: 1. Cifrar texto: "Encrypt this message: Hello World" 2. Descifrar datos: "Decrypt this data that was previously encrypted for me"Cifrar: {"ciphertext":[89,32,155,38,125,22,49,226,26,...]} Descifrar: {"plaintext":"hello world"}
wallet_getAddressDevuelve una dirección BSV para la billetera actual o una ruta derivada{"address":"1ExampleBsvAddressXXXXXXXXXXXXXXXXX","status":"ok"}
wallet_sendToAddressEnvía BSV a una dirección específica (admite montos en BSV o USD){"status":"success","txid":"a1b2c3d4e5f6...","satoshis":1000000}
wallet_purchaseListingCompra NFT o tokens BSV-20/BSV-21 de los listados del mercado{"status":"success","txid":"a1b2c3d4e5f6...","type":"nft","origin":"abcdef123456..."}
wallet_createOrdinalsCrea e inscribe ordinales en la cadena de bloques BSV{"txid":"a1b2c3d4e5f6...","inscriptionAddress":"1ExampleAddress...","contentType":"image/png"}

Herramientas BSV

Herramientas para interactuar con la cadena de bloques y la red BSV:

Nombre de la herramientaDescripciónEjemplo de salida
bsv_getPriceObtiene el precio actual de BSV desde una API de intercambioCurrent BSV price: $38.75 USD
bsv_decodeTransactionDecodifica una transacción BSV y devuelve información detallada{"txid":"a1b2c3d4e5f6...","version":1,"locktime":0,"size":225,"inputs":[...],"outputs":[...]}
bsv_exploreHerramienta integral de exploración de blockchain que accede a los puntos finales de la API de WhatsOnChain{"chain_info":{"chain":"main","blocks":826458,"headers":826458,"bestblockhash":"0000000000..."}}

Herramientas de ordinales

Herramientas para trabajar con ordinales (NFT) en BSV:

Nombre de la herramientaDescripciónEjemplo de salida
ordinals_getInscriptionRecupera información detallada sobre una inscripción específica{"id":"a1b2c3d4e5f6...","origin":"a1b2c3d4e5f6...","contentType":"image/png","content":"iVBORw0KGgoAAA..."}
ordinals_searchInscriptionsBúsquedas de inscripciones basadas en diversos criterios{"results":[{"id":"a1b2c3...","contentType":"image/png","owner":"1Example..."},...]}
ordinals_marketListingsRecupera listados de mercado para tokens NFT, BSV-20 y BSV-21 con una interfaz unificada{"results":[{"txid":"a1b2c3...","price":9990000,"tick":"PEPE","listing":true},...]}
ordinals_marketSalesObtiene información sobre las ventas en el mercado de tokens BSV-20 y BSV-21{"results":[{"txid":"a1b2c3...","price":34710050,"tick":"$BTC","sale":true},...]}
ordinals_getTokenByIdOrTickerRecupera detalles sobre un token BSV20 específico por ID{"tick":"PEPE","max":"21000000","lim":"1000","dec":"2"}

Herramientas de utilidad

Funciones de utilidad de propósito general:

Nombre de la herramientaDescripciónEjemplo de salida
utils_convertDataConvierte datos entre diferentes formatos de codificación (utf8, hex, base64, binario). Parámetros: - data (obligatorio): La cadena a convertir- from (obligatorio): Formato de codificación de origen (utf8, hexadecimal, base64 o binario)- to (obligatorio): Formato de codificación de destino (utf8, hexadecimal, base64 o binario) Ejemplos: - UTF-8 a hexadecimal: {"data": "hello world", "from": "utf8", "to": "hex"} → 68656c6c6f20776f726c64 - UTF-8 a base64: {"data": "Hello World", "from": "utf8", "to": "base64"} → SGVsbG8gV29ybGQ= - base64 a UTF-8: {"data": "SGVsbG8gV29ybGQ=", "from": "base64", "to": "utf8"} → Hello World - Hex a base64: {"data": "68656c6c6f20776f726c64", "from": "hex", "to": "base64"} → aGVsbG8gd29ybGQ= Notas: - Todos los parámetros son obligatorios. - La herramienta devuelve los datos convertidos como una cadena. - Para la conversión binaria, los datos se representan como una matriz de valores de bytes."SGVsbG8gV29ybGQ=" (UTF-8 "Hola Mundo" convertido a base64)

Herramientas MNEE

Herramientas para trabajar con tokens MNEE:

Nombre de la herramientaDescripciónEjemplo de salida
mnee_getBalanceRecupera el saldo actual del token MNEE para la billetera{"balance": {"amount": 2900, "decimalAmount": 0.029}}
mnee_sendMneeEnvía tokens MNEE a una dirección específica. Admite cantidades de MNEE y USD.{"success": true, "txid": "d1ce853934964e6c1fe9f44c918a824f175c6ab466b966f49ebc0682a8318895", "rawtx": "0100000002a0be40d8942015f1...", "mneeAmount": 0.01, "usdAmount": "$0.01", "recipient": "15mNxEkyKJXPD8amic6oLUjS45zBKQQoLu"}
mnee_parseTxAnalice una transacción MNEE para obtener información detallada sobre sus operaciones y montos. Todos los montos se expresan en unidades atómicas con una precisión de 5 decimales (p. ej., 1000 unidades atómicas = 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}]}

Uso de las herramientas con MCP

Una vez conectado, podrá interactuar con Bitcoin SV en lenguaje natural a través de su asistente de IA. Aquí tiene algunos ejemplos:

Operaciones de billetera

  • Obtener mi dirección de Bitcoin SV
  • "Enviar 0,01 BSV a 1ExampleBsvAddressXXXXXXXXXXXXXXXXXX"
  • "Envía BSV por valor de $5 USD a 1ExampleBsvAddressXXXXXXXXXXXXXXXXXX"
  • "Enviar 0,01 MNEE a 1ExampleBsvAddressXXXXXXXXXXXXXXXXXX"
  • Consultar mi saldo de MNEE
  • Analizar esta transacción MNEE: txid
  • "Cifrar este mensaje con las claves de mi billetera"
  • "Descifrar estos datos que previamente fueron cifrados para mí"
  • Compra este NFT: txid_vout
  • Compre este token BSV-20: txid_vout

Ordinales (NFT)

  • Muéstrame información sobre el NFT con el punto de salida 6a89047af2cfac96da17d51ae8eb62c5f1d982be2bc4ba0d0cd2084b7ffed325_0
  • Búsqueda de NFT de Pixel Zoide
  • "Muéstrame las listas actuales de NFT de BSV en el mercado"
  • Muéstrame listados de tokens BSV-20 para el ticker PEPE.
  • Consulta las ventas recientes de tokens BSV-20.

Operaciones de blockchain

  • "¿Cuál es el precio actual del BSV?"
  • "Decodificar esta transacción BSV: (código hexadecimal o ID de la transacción)"
  • Obtén la información más reciente sobre la cadena Bitcoin SV.
  • "Muéstrame los detalles del bloque para la altura 800000"
  • Explorar el historial de transacciones de la dirección 1ExampleBsvAddressXXXX
  • "Verificar las salidas no gastadas (UTXO) de mi dirección de billetera"
  • Obtener detalles de la transacción con hash a1b2c3d4e5f6

Conversión de datos

  • Convertir "Hola Mundo" de UTF-8 a formato hexadecimal

Indicaciones y recursos de MCP

El servidor MCP de BSV ofrece indicaciones y recursos especializados que proporcionan información detallada y contexto sobre las tecnologías de Bitcoin SV. Los modelos de IA pueden acceder a ellos para mejorar su comprensión y capacidades.

Indicaciones disponibles

El servidor proporciona las siguientes indicaciones educativas a las que se puede acceder directamente a través del protocolo MCP:

Indicación de ordinales
  • Identificador : bitcoin_sv_ordinals
  • Descripción : Información completa sobre los ordinales de Bitcoin SV, incluyendo qué son, cómo funcionan y cómo usarlos.
  • Uso : Pregunte al asistente sobre "Ordinales de Bitcoin SV" u "Ordinales 1Sat" para acceder a esta información.
Indicaciones del SDK de BSV

Una colección de indicaciones que brindan información detallada sobre el SDK de Bitcoin SV:

  • Descripción general
    • Identificador : bitcoin_sv_sdk_overview
    • Descripción : Descripción general del SDK de Bitcoin SV, incluido su propósito y componentes principales.
    • Uso : "Cuéntame sobre el SDK de BSV" o "¿Qué es el SDK de Bitcoin SV?"
  • Operaciones de billetera
    • Identificador : bitcoin_sv_sdk_wallet
    • Descripción : Información sobre las operaciones de billetera en el SDK de BSV.
    • Uso : "¿Cómo funcionan las operaciones de billetera en el SDK de BSV?"
  • Edificio de transacciones
    • Identificador : bitcoin_sv_sdk_transaction
    • Descripción : Detalles sobre la creación y manipulación de transacciones.
    • Uso : "Explique la creación de transacciones con BSV SDK" o "¿Cómo creo transacciones con BSV SDK?"
  • Autenticación
    • Identificador : bitcoin_sv_sdk_auth
    • Descripción : Protocolos de autenticación e identidad en BSV SDK.
    • Uso : "¿Cómo funciona la autenticación con BSV SDK?"
  • Criptografía
    • Identificador : bitcoin_sv_sdk_cryptography
    • Descripción : Funcionalidad de firma, cifrado y verificación.
    • Uso : "Explicar las funciones criptográficas del SDK de BSV"
  • Scripting
    • Identificador : bitcoin_sv_sdk_script
    • Descripción : Capacidades de creación de scripts y contratos de Bitcoin.
    • Uso : "¿Cómo trabajo con scripts de Bitcoin usando el SDK BSV?"
  • Primitivos
    • Identificador : bitcoin_sv_sdk_primitives
    • Descripción : Tipos de datos y estructuras principales en el SDK de BSV.
    • Uso : "¿Qué primitivas están disponibles en el SDK de BSV?"

Recursos disponibles

El servidor también proporciona acceso a las especificaciones y documentación de la Solicitud de comentarios (BRC) de Bitcoin:

Recurso del registro de cambios
  • Identificador : bsv-mcp-changelog
  • Descripción : Historial de versiones y registro de cambios del servidor BSV MCP.
  • Uso : "Muéstrame el registro de cambios de BSV MCP" o "¿Qué hay de nuevo en la última versión?"
Recursos de BRC
  • Descripción general de los BRC
    • Identificador : brcs_readme
    • Descripción : Descripción general de todas las especificaciones del protocolo Bitcoin SV en el repositorio BRC.
    • Uso : "Muéstrame la descripción general de los BRC de Bitcoin SV"
  • Resumen de BRC
    • Identificador : brcs_summary
    • Descripción : Tabla de contenidos de todos los BRC de Bitcoin SV.
    • Uso : "Dame un resumen de los BRC de Bitcoin SV"
  • Especificaciones específicas de BRC
    • Identificador : brc_spec
    • Descripción : Acceda a especificaciones BRC específicas por categoría y número.
    • Uso : "Muéstrame BRC 8 en los sobres de transacción" o "¿Qué especifica BRC 1?"
Categorías BRC

Las especificaciones BRC están organizadas en las siguientes categorías:

  • Billetera
  • Actas
  • Guiones
  • Fichas
  • Superposiciones
  • Pagos
  • De igual a igual
  • Derivación de claves
  • Puntos de salida
  • Opiniones
  • Máquinas de estados
  • Aplicaciones

Uso de indicaciones y recursos

Los modelos de IA pueden usar estas indicaciones y recursos para proporcionar respuestas más precisas y detalladas sobre las tecnologías de Bitcoin SV. Como usuario, puedes:

  1. Pregunte sobre un tema específico : "Cuénteme sobre los ordinales de Bitcoin SV" o "Explique la creación de transacciones del SDK de BSV".
  2. Solicitar detalles específicos del BRC : "¿Qué especifica el BRC 8?" o "Muéstrame el BRC al crear la transacción".
  3. Obtenga descripciones generales : "¿Qué es el SDK de BSV?" o "Muéstrame un resumen de todos los BRC".

Estas indicaciones y recursos mejoran la base de conocimientos de la IA, lo que permite respuestas más técnicas y precisas incluso para temas complejos de Bitcoin SV.

Cómo funciona MCP

Cuando interactúas con un asistente de IA habilitado para MCP:

  1. La IA analiza tu solicitud y decide qué herramientas utilizar
  2. Con su aprobación, llama a la herramienta BSV MCP adecuada
  3. El servidor ejecuta la operación solicitada en la cadena de bloques de Bitcoin SV
  4. Los resultados se devuelven al asistente de IA.
  5. El asistente presenta la información de forma natural y conversacional.

Opciones de personalización

El servidor BSV MCP se puede personalizar mediante variables de entorno para habilitar o deshabilitar componentes específicos:

Configuración de componentes

Variable de entornoPor defectoDescripción
DISABLE_PROMPTSfalseEstablezca en true para deshabilitar todas las indicaciones educativas
DISABLE_RESOURCESfalseEstablezca como true para deshabilitar todos los recursos (BRC, registro de cambios)
DISABLE_TOOLSfalseEstablezca en true para deshabilitar todas las herramientas

Configuración específica de la herramienta

Variable de entornoPor defectoDescripción
DISABLE_WALLET_TOOLSfalseEstablezca en true para deshabilitar las herramientas de billetera de Bitcoin
DISABLE_MNEE_TOOLSfalseEstablezca en true para deshabilitar las herramientas de token MNEE
DISABLE_BSV_TOOLSfalseEstablezca en true para deshabilitar las herramientas de blockchain de BSV
DISABLE_ORDINALS_TOOLSfalseEstablezca en true para deshabilitar las herramientas ordinales/NFT
DISABLE_UTILS_TOOLSfalseEstablezca en true para deshabilitar las herramientas de utilidad
IDENTITY_KEY_WIFnot setWIF opcional para clave de identidad; si se configura, las inscripciones de ordinales se firmarán con el protocolo sigma para autenticación, curación y web de confianza.
DISABLE_BROADCASTINGfalseEstablezca en true para deshabilitar la transmisión de transacciones; en su lugar, devuelve el hexadecimal de la transacción sin procesar: útil para probar y revisar la transacción antes de la transmisión

Ejemplos

Ejecute únicamente con recursos y estímulos educativos, sin herramientas:

DISABLE_TOOLS=true bunx bsv-mcp@latest

Ejecute solo con herramientas BSV, sin billetera ni otra funcionalidad:

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

Utilice todas las herramientas excepto las operaciones de billetera:

DISABLE_WALLET_TOOLS=true bunx bsv-mcp@latest

Crear transacciones sin difundirlas (modo de prueba):

DISABLE_BROADCASTING=true bunx bsv-mcp@latest

Solución de problemas

Si tiene problemas con el servidor BSV MCP:

Problemas de conexión

  1. Asegúrese de que Bun o Node.js esté instalado en su sistema
  2. Verifique que su clave privada WIF esté configurada correctamente en el entorno
  3. Compruebe que su cliente sea compatible con MCP y esté configurado correctamente
  4. Busque mensajes de error en la salida de la consola del cliente

Manteniendo a Bun actualizado

Es importante mantener Bun actualizado a la última versión para garantizar la compatibilidad:

# Update Bun to the latest version bun upgrade

Para verificar su versión actual de Bun:

bun --version

Registro y depuración

Para Claude for Desktop, consulte los registros en:

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

Para Cursor, verifique los registros de MCP de Cursor en Configuración → Extensiones → Protocolo de contexto de modelo.

Actualizaciones recientes

  • Control de transmisión de transacciones : se agregó la variable de entorno DISABLE_BROADCASTING para evitar que las transacciones se transmitan a la red
  • Blockchain Explorer : Se agregó la herramienta bsv_explore para el acceso a la API de WhatsOnChain con compatibilidad con mainnet/testnet
  • Herramientas unificadas : wallet_encrypt y wallet_decrypt se fusionaron en una única herramienta wallet_encryption
  • Mercado mejorado : compatibilidad con NFT y tokens BSV-20/21 en listados, ventas y compras
  • Rendimiento : Se agregó almacenamiento en caché de precios y se optimizó la estructura del punto final de la API.
  • Validación mejorada : mejor manejo de errores para claves privadas y parámetros

Explorador de cadenas de bloques de Bitcoin SV

La herramienta bsv_explore proporciona acceso completo a la blockchain de Bitcoin SV a través de la API WhatsOnChain. Esta potente herramienta de exploración permite consultar diversos aspectos de la blockchain, incluyendo datos de la cadena, bloques, transacciones e información de direcciones.

Puntos finales disponibles

La herramienta admite las siguientes categorías de puntos finales y puntos finales específicos:

Datos de la cadena
Punto finalDescripciónParámetros requeridosEjemplo de respuesta
chain_infoEstadísticas de red, dificultad y trabajo en cadenaNinguno{"chain":"main","blocks":826458,"headers":826458,"bestblockhash":"0000000000..."}
chain_tipsConsejos actuales sobre la cadena, incluidas alturas y estadosNinguno[{"height":826458,"hash":"000000000000...","branchlen":0,"status":"active"}]
circulating_supplySuministro circulante actual de BSVNinguno{"bsv":21000000}
peer_infoEstadísticas de pares conectadosNinguno[{"addr":"1.2.3.4:8333","services":"000000000000...","lastsend":1621234567}]
Bloquear datos
Punto finalDescripciónParámetros requeridosEjemplo de respuesta
block_by_hashDatos de bloque completos mediante hashblockHash{"hash":"000000000000...","confirmations":1000,"size":1000000,...}
block_by_heightDatos de bloque completos por alturablockHeight{"hash":"000000000000...","confirmations":1000,"size":1000000,...}
tag_count_by_heightEstadísticas sobre el recuento de etiquetas para un bloque específicoblockHeight{"tags":{"amp":3,"bitkey":5,"metanet":12,"planaria":7,"b":120}}
block_headersRecupera los últimos 10 encabezados de bloqueNinguno[{"hash":"000000000000...","height":826458,"version":536870912,...},...]
block_pagesRecupera páginas de ID de transacciones para bloques grandesblockHash , opcional: pageNumber["tx1hash","tx2hash","tx3hash",...]
Datos estadísticos
Punto finalDescripciónParámetros requeridosEjemplo de respuesta
block_stats_by_heightEstadísticas de bloque para una altura específicablockHeight{"size":123456,"txCount":512,"outputTotal":54.12345678,"outputTotalUsd":2345.67,...}
block_miner_statsEstadísticas de minería de bloques durante un período de tiempoopcional: days (predeterminado 7){"blocks":{"miner1":412,"miner2":208,...},"total":1008}
miner_summary_statsResumen de las estadísticas minerasopcional: days (predeterminado 7){"totalBlocks":1008,"totalFees":1.23456789,"totalFeesUsd":53.67,...}
Datos de la transacción
Punto finalDescripciónParámetros requeridosEjemplo de respuesta
tx_by_hashDatos detallados de las transaccionestxHash{"txid":"a1b2c3d4e5f6...","version":1,"locktime":0,"size":225,...}
tx_rawDatos hexadecimales de transacciones sin procesartxHash"01000000012345abcdef..."
tx_receiptRecibo de transaccióntxHash{"blockHash":"000000000000...","blockHeight":800000,"confirmations":26458}
bulk_tx_detailsRecuperar múltiples transacciones en una sola solicitudtxids (matriz)[{"txid":"a1b2c3d4e5f6...","version":1,...}, {"txid":"b2c3d4e5f6a7...","version":1,...}]
Datos de dirección
Punto finalDescripciónParámetros requeridosEjemplo de respuesta
address_historyHistorial de transacciones de la direcciónaddress , opcional: limit[{"tx_hash":"a1b2c3d4e5f6...","height":800000},...]
address_utxosSalidas no utilizadas para la direcciónaddress[{"tx_hash":"a1b2c3d4e5f6...","tx_pos":0,"value":100000},...]
Red
Punto finalDescripciónParámetros requeridosEjemplo de respuesta
healthComprobación del estado de la APINinguno{"status":"synced"}

Ejemplos de uso

La herramienta bsv_explore se puede utilizar con indicaciones en lenguaje natural como:

"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"

Bajo el capó, la herramienta acepta parámetros para especificar qué datos recuperar:

  • endpoint : el punto final específico de WhatsOnChain para consultar (por ejemplo, chain_info , tx_by_hash )
  • network : La red BSV a utilizar ( main o test )
  • Parámetros adicionales según lo requiera el punto final específico:
    • blockHash : para puntos finales block_by_hash y block_pages
    • blockHeight : para los puntos finales block_by_height, tag_count_by_height y block_stats_by_height
    • pageNumber : Para el punto final block_pages (paginación)
    • days : para los puntos finales block_miner_stats y miner_summary_stats (el valor predeterminado es 7)
    • txHash : para puntos finales relacionados con transacciones (tx_by_hash, tx_raw, tx_receipt)
    • txids : para el punto final bulk_tx_details (matriz de ID de transacción)
    • address : para puntos finales relacionados con la dirección
    • limit : límite de paginación opcional para address_history

Opciones de red

La herramienta es compatible tanto con la red principal como con la red de prueba:

  • main : red principal de Bitcoin SV (predeterminada)
  • test : red de pruebas de Bitcoin SV

Desarrollo

Configuración del proyecto

Si quieres contribuir al proyecto o ejecutarlo localmente:

  1. Clonar el repositorio:
    git clone https://github.com/b-open-io/bsv-mcp.git cd bsv-mcp
  2. Instalar dependencias:
    bun install # or with npm npm install

Ejecución del servidor

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

Ejecución de pruebas

bun test # or with npm npm test

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

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

Una colección de herramientas de Bitcoin SV para el Protocolo de Contexto de Modelo que permite a los asistentes de IA interactuar con la cadena de bloques BSV a través de operaciones de billetera, ordinales (NFT) y varias utilidades de cadena de bloques.

  1. Instalación y configuración
    1. Usar pan (opcional pero recomendado)
  2. Conexión a clientes MCP
    1. Cursor
    2. Claude para escritorio
  3. Herramientas disponibles
    1. Herramientas de billetera
    2. Herramientas BSV
    3. Herramientas de ordinales
    4. Herramientas de utilidad
    5. Herramientas MNEE
  4. Uso de las herramientas con MCP
    1. Operaciones de billetera
    2. Ordinales (NFT)
    3. Operaciones de blockchain
    4. Conversión de datos
  5. Indicaciones y recursos de MCP
    1. Indicaciones disponibles
    2. Recursos disponibles
    3. Uso de indicaciones y recursos
  6. Cómo funciona MCP
    1. Opciones de personalización
      1. Configuración de componentes
      2. Configuración específica de la herramienta
      3. Ejemplos
    2. Solución de problemas
      1. Problemas de conexión
      2. Manteniendo a Bun actualizado
      3. Registro y depuración
    3. Actualizaciones recientes
      1. Explorador de cadenas de bloques de Bitcoin SV
        1. Puntos finales disponibles
        2. Ejemplos de uso
        3. Opciones de red
      2. Desarrollo
        1. Configuración del proyecto
        2. Ejecución del servidor
        3. Licencia

      Related MCP Servers

      • Bitcoin MCP Server

        AbdelStark
        A
        security
        A
        license
        A
        quality
        Facilitates interaction with the Bitcoin network via the Model Context Protocol, enabling key generation, address validation, transaction decoding, and blockchain data retrieval.
        Last updated -
        5
        573
        54
        TypeScript
        MIT License
        • Apple

      • MCP Blockchain Query Server

        pavel-bc
        -
        security
        F
        license
        -
        quality
        A Model Context Protocol server providing tools for querying Bitcoin blockchain data via Blockchain Data and Query APIs, supporting various BTC information retrieval functions.
        Last updated -
        Python
        • Linux
        • Apple

      • Bitbucket MCP

        MatanYemini
        A
        security
        A
        license
        A
        quality
        A Model Context Protocol server that enables AI assistants to interact with Bitbucket repositories, pull requests, and other resources through Bitbucket Cloud and Server APIs.
        Last updated -
        3
        112
        9
        JavaScript
        MIT License
        • Linux
        • Apple

      • Hexiaoyi MCP

        dddd-community
        -
        security
        A
        license
        -
        quality
        A powerful toolkit that enables seamless interaction with EVM-compatible networks through natural language processing and AI assistance, allowing users to manage wallets, launch tokens, and interact with blockchain networks.
        Last updated -
        0
        JavaScript
        MIT License

      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