Servidor MCP de Hedera

Un servidor de Protocolo de Contexto de Modelo (MCP) para interactuar con la red Hedera. Este servidor proporciona herramientas para crear billeteras Hedera, consultar saldos de cuentas, generar transacciones y enviar transacciones firmadas.

⚠️ Advertencia de seguridad

Esta es una implementación de demostración y NO debe usarse en producción. La implementación actual presenta varias vulnerabilidades de seguridad:

• Las claves privadas se envían en los cuerpos de respuesta.

• Sin cifrado de datos sensibles

• No hay mecanismos de verificación de transacciones

Esta implementación está destinada a demostrar el concepto MCP y debe protegerse adecuadamente antes de utilizarse en un entorno de producción.

Related MCP server: MCP Clusters API Server

Objetivos principales

El propósito principal de este servidor MCP es demostrar cómo el servidor MCP puede gestionar la construcción y ejecución de transacciones, de modo que el cliente solo tenga que verificar la transacción. En concreto:

1. La construcción de transacciones ocurre completamente en el servidor MCP

2. Los clientes firman las transacciones construidas

3. El servidor MCP gestiona el envío de transacciones a la red Hedera

4. Esta arquitectura permite una lógica de transacciones centralizada y reduce la complejidad del lado del cliente.

Prerrequisitos

• Node.js (v18 o superior)

• npm o hilo

• Una cuenta Hedera (para testnet o mainnet)

Instalación

1. Clonar este repositorio:

   git clone https://github.com/hedera-dev/hedera-mcp-server.git
   cd hedera-mcp-server

2. Instalar dependencias:

   npm install

3. Cree un archivo .env en el directorio raíz con sus credenciales de Hedera:

   HEDERA_OPERATOR_ID=your-operator-account-id
   HEDERA_OPERATOR_KEY=your-operator-private-key
   HEDERA_NETWORK=testnet  # or mainnet
   PORT=3000  # optional, defaults to 3000

Construyendo la aplicación

Compilar el código TypeScript:

npm run build

Para el desarrollo con recompilación automática:

npm run dev

Ejecución del servidor

Iniciar el servidor:

npm start

El servidor estará disponible en http://localhost:3000 (o el puerto especificado en su archivo .env).

Pruebas con el cliente de prueba

El repositorio incluye un script de cliente de prueba que muestra cómo conectarse al servidor MCP y usar sus herramientas. Este cliente proporciona un flujo completo de principio a fin que muestra todas las herramientas disponibles.

Ejecute el cliente de prueba:

node test-client.js

El cliente de prueba hará lo siguiente:

1. Conectarse al servidor MCP

2. Lista de herramientas disponibles

3. Crear una nueva billetera Hedera (herramienta de creación de billetera)

4. Consultar el saldo de la nueva cuenta (herramienta de consulta de saldo)

5. Crear una transacción transfiriendo el saldo completo de la cuenta a la cuenta del operador (herramienta de creación de transacciones)

6. Firme la transacción en el lado del cliente utilizando el SDK de Hedera

7. Envíe la transacción firmada a la red Hedera (herramienta de envío de transacciones)

8. Mostrar el resultado de la transacción

Esto demuestra el ciclo de vida completo de la interacción con la red Hedera a través del servidor MCP, desde la creación de la cuenta hasta el envío de la transacción.

Herramientas MCP disponibles

El servidor proporciona las siguientes herramientas:

1. create-wallet : crea una nueva cuenta Hedera con un saldo inicial mínimo

   • No se requieren parámetros de entrada

   • Devuelve el ID de cuenta, la clave pública y la clave privada.

2. check-balance : Comprueba el saldo de una cuenta Hedera

   • Entrada: accountId (cadena)

   • Devuelve el saldo de la cuenta en tinybars

3. build-transaction : Crea una transacción de transferencia (sin firmar)

   • Entradas:

     • senderAccountId (cadena)

     • recipientAccountId (cadena)

     • amount (número, en barras diminutas)

   • Devuelve una transacción codificada en base64

4. send-transaction : envía una transacción firmada a la red Hedera

   • Entrada: signedTransaction (cadena, codificada en base64)

   • Devuelve el estado y la identificación de la transacción

Despliegue

Se incluye un script de implementación simple:

./deploy.sh

Asegúrese de hacerlo ejecutable primero:

chmod +x deploy.sh