Servidor BSC MCP

Un servidor de Protocolo de Contexto de Modelo (MCP) para interactuar con la red Binance Smart Chain (BSC). Este servidor permite a los LLM acceder a los datos de la blockchain y realizar consultas en la red BSC.

Características

Obtener el número de bloque actual
Recuperar detalles del bloque por número o hash
Obtener detalles de la transacción
Obtener recibos de transacciones
Consultar el saldo de la billetera BNB
Consultar saldos de tokens BEP-20
Crea tokens Four.meme en BSC

Prerrequisitos

Node.js (v16 o superior)
npm o hilo

Instalación

# Clone the repository
git clone https://github.com/ArcReactor9/BSC_MCP_SERVICES.git
cd BSC_MCP_SERVICES

# Install dependencies
npm install

# Build the project
npm run build

Uso

Configuración

De forma predeterminada, el servidor se conecta a la red principal de BSC. Puede personalizar la URL de RPC y configurar la clave privada (necesaria para la creación del token) mediante variables de entorno:

# Windows
set BSC_RPC_URL=https://your-custom-bsc-rpc-url
set BSC_PRIVATE_KEY=your-private-key

# Linux/macOS
export BSC_RPC_URL=https://your-custom-bsc-rpc-url
export BSC_PRIVATE_KEY=your-private-key

Ejecución del servidor STDIO

El servidor STDIO está diseñado para integrarse con clientes LLM que admiten el protocolo MCP:

npm run start
# or
node dist/index.js

Ejecución del servidor HTTP/SSE

El servidor HTTP/SSE permite conexiones a través de HTTP mediante eventos enviados por el servidor:

npm run start:http
# or
node dist/server-http.js

De forma predeterminada, el servidor se ejecuta en el puerto 3000. Puede personalizar el puerto utilizando la variable de entorno PORT .

Ejemplos de clientes

Se proporcionan varias implementaciones de cliente para demostrar cómo utilizar el servidor BSC MCP:

# Standard MCP client example
npm run client
# or
node dist/client-example.js

# HTTP client example
npm run client:http
# or
node dist/client-http-example.js

# Simple HTTP client example
npm run client:simple
# or
node dist/simple-http-client.js

Puntos finales de API (servidor HTTP)

El servidor HTTP expone los siguientes puntos finales:

Punto final	Método	Descripción
`/`	CONSEGUIR	Comprobación del estado del servidor
`/mcp/hello`	CORREO	Obtener información del servidor y las herramientas disponibles
`/mcp/tools/:toolName`	CORREO	Llamar a una herramienta específica con argumentos
`/mcp/sse`	CONSEGUIR	Punto final de eventos enviados por el servidor (SSE) para conexiones de streaming

Herramientas MCP

Este servidor expone las siguientes herramientas MCP:

Nombre de la herramienta	Parámetros	Descripción
`get-block-number`	Ninguno	Devuelve el número de bloque BSC actual
`get-block`	`blockHashOrNumber` : cadena o número	Devuelve los detalles del bloque para el hash o número de bloque dado
`get-transaction`	`txHash` : cadena	Devuelve los detalles de la transacción para el hash de transacción dado
`get-transaction-receipt`	`txHash` : cadena	Devuelve el recibo de transacción para el hash de transacción dado
`get-balance`	`address` : cadena	Devuelve el saldo de BNB para la dirección de billetera indicada
`get-token-balance`	`tokenAddress` : cadena, `walletAddress` : cadena	Devuelve el saldo del token BEP-20 para el token y la dirección de billetera indicados
`create-four-meme-token`	`name` : cadena, `symbol` : cadena, `initialSupply` : número, `decimals` : número, `ownerAddress` : cadena	Crea un nuevo token Four.meme con parámetros especificados

Creación de tokens Four.meme

El servidor BSC MCP incluye la función para crear nuevos tokens Four.meme en Binance Smart Chain. Esto permite a los usuarios implementar fácilmente tokens meme personalizados con los siguientes parámetros:

name : El nombre completo del token (por ejemplo, "Four Meme Token")
symbol : El símbolo del token (por ejemplo, "4MEME")
initialSupply : El suministro inicial de tokens para acuñar
decimals : el número de decimales para el token (normalmente 18)
ownerAddress : La dirección BSC que recibirá el suministro inicial de tokens

Ejemplo utilizando un cliente HTTP

// Example of creating a Four.meme token using the HTTP client
const client = new SimpleHttpClient('http://localhost:3000');

// Create a Four.meme token
const tokenResponse = await client.createFourMemeToken(
  'Four Pepe',   // Token name
  '4PEPE',       // Token symbol
  420690000000,  // Initial supply (before decimals)
  18,            // Decimals
  '0xYourWalletAddress'  // Owner address
);

console.log('Token creation response:', tokenResponse);

Integración con MCP.so

Para mostrar correctamente este servicio en mcp.so , asegúrese de que su repositorio contenga lo siguiente:

Un README.md bien documentado (este archivo)
Ejemplos de código que demuestran cómo utilizar las herramientas
Especificaciones de herramientas claramente definidas

Desarrollo

Estructura del proyecto

BSC_MCP_SERVICES/
├── dist/               # Compiled JavaScript files
├── src/                # TypeScript source code
│   ├── bsc-service.ts  # BSC interaction service
│   ├── index.ts        # STDIO server implementation
│   ├── server-http.ts  # HTTP/SSE server implementation
│   └── ...             # Client examples and utilities
├── package.json        # Project dependencies and scripts
└── README.md           # Project documentation (this file)

Construyendo el Proyecto

npm run build

Licencia

ISC

Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.

Solución de problemas

Problemas de creación de tokens

Asegúrese de que la variable de entorno BSC_PRIVATE_KEY esté configurada correctamente
Verifique que tenga suficiente BNB para cubrir las tarifas de gas para la implementación del token
Verifique que la dirección del propietario sea una dirección BSC válida

Problemas de conexión

Verifique que la URL de RPC sea correcta y accesible
Comprobar la conectividad de la red
Asegúrese de que el servidor se esté ejecutando en el puerto esperado

Apoyo

Para cualquier pregunta o ayuda, abra un problema en el repositorio de GitHub.

BSC MCP Server

Integrations