bnbchain-mcp

Protocolo de contexto de modelo (MCP) de BNBChain

Un poderoso conjunto de herramientas para interactuar con BNB Chain y otras redes compatibles con EVM a través del procesamiento del lenguaje natural y la asistencia de IA.

Descripción

BNBChain MCP es una implementación del Protocolo de Contexto de Modelo que permite una interacción fluida con redes blockchain mediante interfaces basadas en IA. Proporciona un conjunto completo de herramientas y recursos para el desarrollo de blockchain, la interacción con contratos inteligentes y la gestión de redes.

Módulos principales

El proyecto está organizado en varios módulos principales:

Bloques : Consulta y gestiona bloques de blockchain
Contratos : Interactúa con contratos inteligentes
Red : Información y gestión de redes
NFT : Operaciones NFT (ERC721/ERC1155)
Tokens : Operaciones con tokens (ERC20)
Transacciones : Gestión de transacciones
Monedero : Operaciones y gestión del monedero
Común : Utilidades y tipos compartidos
Próximamente se añadirán funciones adicionales (Greenfield, Swap, Bridge, etc.)

Integración con Cursor

Para conectarse al servidor MCP desde Cursor:

Abra Cursor y vaya a Configuración (ícono de engranaje en la parte superior derecha)
Haga clic en "MCP" en la barra lateral izquierda
Haga clic en "Agregar nuevo servidor MCP global".
Introduzca los siguientes datos:

Modo predeterminado

{
  "mcpServers": {
    "bnbchain-mcp": {
      "command": "npx",
      "args": ["-y", "@bnb-chain/mcp@latest"],
      "env": {
        "PRIVATE_KEY": "your_private_key_here. (optinal)"
      }
    }
  }
}

Modo SSE

{
  "mcpServers": {
    "bnbchain-mcp": {
      "command": "npx",
      "args": ["-y", "@bnb-chain/mcp@latest", "--sse"],
      "env": {
        "PRIVATE_KEY": "your_private_key_here. (optinal)"
      }
    }
  }
}

Integración con Claude Desktop

Para conectarse al servidor MCP desde Claude Desktop:

Abra Claude Desktop y vaya a Configuración
Haga clic en "Desarrollador" en la barra lateral izquierda.
Haga clic en el botón "Editar configuración"
Agregue la siguiente configuración al archivo claude_desktop_config.json :

{
  "mcpServers": {
    "bnbchain-mcp": {
      "command": "npx",
      "args": ["-y", "@bnb-chain/mcp@latest"],
      "env": {
        "PRIVATE_KEY": "your_private_key_here"
      }
    }
  }
}

Guarde el archivo y reinicie Claude Desktop

Una vez conectado, podrá usar todas las indicaciones y herramientas de MCP directamente en sus conversaciones de Claude Desktop. Por ejemplo:

"Analizar esta dirección: 0x123..."
"Explicar el concepto EVM del gas"
Consulta el último bloque en BSC

Integración con otros clientes

Si desea integrar BNBChain MCP en su propio cliente, consulte el directorio de ejemplos para obtener información más detallada e implementaciones de referencia.

Los ejemplos demuestran:

Cómo configurar el cliente MCP
Autenticación y configuración
Realizar llamadas API para interactuar con redes blockchain
Manejo de respuestas y errores
Mejores prácticas para la integración

Desarrollo local

Prerrequisitos

bun v1.2.10 o superior
Node.js v17 o superior

Inicio rápido

Clonar el repositorio:

git clone https://github.com/bnb-chain/bnbchain-mcp.git
cd bnbchain-mcp

Configurar variables de entorno:

cp .env.example .env

Edite el archivo .env con su configuración:

PRIVATE_KEY : La clave privada de su billetera (requerida para las operaciones de transacción)
LOG_LEVEL : Establece el nivel de registro (DEBUG, INFO, WARN, ERROR)
PORT : Número de puerto del servidor (predeterminado: 3001)

Instalar dependencias e iniciar el servidor de desarrollo:

# Install project dependencies
bun install

# Start the development server
bun dev:sse

Pruebas con clientes MCP

Configure el servidor local en sus clientes MCP usando esta plantilla:

{
  "mcpServers": {
    "bnbchain-mcp": {
      "url": "http://localhost:3001/sse",
      "env": {
        "PRIVATE_KEY": "your_private_key_here"
      }
    }
  }
}

Pruebas con interfaz de usuario web

Usamos @modelcontextprotocol/inspector para las pruebas. Ejecutamos la interfaz de usuario de prueba:

bun run test

Scripts disponibles

bun dev:sse : Iniciar el servidor de desarrollo con recarga en caliente
bun build : Construye el proyecto
bun test : ejecutar conjunto de pruebas

Indicaciones y herramientas disponibles

Indicaciones

Nombre	Descripción
analizar_bloque	Analizar un bloque y proporcionar información detallada sobre su contenido.
analizar_transacción	Analizar una transacción específica
analizar_dirección	Analizar una dirección EVM
interactuar_con_contrato	Obtenga orientación sobre cómo interactuar con un contrato inteligente
explicar_el_concepto_de_evm	Obtenga una explicación de un concepto de EVM
comparar_redes	Comparar diferentes redes compatibles con EVM
analizar_token	Analizar un token ERC20 o NFT

Herramientas

Nombre	Descripción
obtener_bloqueo_por_hash	Obtener un bloque por hash
obtener_bloque_por_número	Obtener un bloque por número
obtener_el_bloque_más_reciente	Obtenga el último bloque
obtener_transacción	Obtenga información detallada sobre una transacción específica por su hash
obtener_recibo_de_transacción	Obtener un recibo de transacción por su hash
estimación_gas	Estimar el costo del gas para una transacción
token nativo de transferencia	Transferir tokens nativos (BNB, ETH, MATIC, etc.) a una dirección
aprobar_gasto_de_tokens	Aprobar otra dirección para gastar tus tokens ERC20
transferencia_nft	Transferir un NFT (token ERC721) de una dirección a otra
transferencia_erc1155	Transferir tokens ERC1155 a otra dirección
transferencia_erc20	Transferir tokens ERC20 a una dirección
obtener_dirección_de_clave_privada	Obtener la dirección EVM derivada de una clave privada
obtener_información_de_la_cadena	Obtener información de la cadena para una red específica
obtener redes compatibles	Obtener lista de redes compatibles
resolver_ens	Resolver un nombre ENS en una dirección EVM
es_contrato	Comprueba si una dirección es un contrato inteligente o una cuenta de propiedad externa (EOA)
leer_contrato	Leer datos de un contrato inteligente llamando a una función de vista/pura
escribir_contrato	Escribe datos en un contrato inteligente llamando a una función de cambio de estado
obtener_información_del_token_erc20	Obtenga información sobre el token ERC20
obtener_saldo_nativo	Obtenga el saldo del token nativo para una dirección
obtener_saldo_erc20	Obtenga el saldo del token ERC20 para una dirección
obtener información de NFT	Obtenga información detallada sobre un NFT específico
comprobar_la_propiedad_de_nft	Comprueba si una dirección posee un NFT específico
obtener_uri_del_token_erc1155	Obtener la URI de metadatos para un token ERC1155
obtener_saldo_nft	Obtenga el número total de NFT que posee una dirección de una colección específica
obtener_saldo_erc1155	Obtenga el saldo de un ID de token ERC1155 específico propiedad de una dirección

Redes compatibles

Compatible con BSC, opBNB, Ethereum y otras redes importantes compatibles con EVM. Para más información, consulte src/evm/chains.ts .

Contribuyendo

¡Agradecemos tus contribuciones al MCP de BNBChain! Puedes ayudar de la siguiente manera:

Bifurcar el repositorio
Crear una rama de características
Confirme sus cambios
Empujar a tu sucursal
Crear una solicitud de extracción

Asegúrese de que su código cumpla con nuestros estándares de codificación e incluya pruebas adecuadas.

Licencia

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

Referencias y agradecimientos

Este proyecto se basa e inspira en los siguientes proyectos de código abierto:

TermiX-official/bsc-mcp - Implementación original del MCP de BSC
mcpdotdirect/evm-mcp-server : implementación de servidor MCP compatible con EVM

Extendemos nuestra gratitud a los autores originales por sus contribuciones al ecosistema blockchain.