Servidor MCP del nodo espejo Hedera Testnet

Este repositorio contiene un servidor de Protocolo de Contexto de Modelo (MCP) que interactúa con la API del Nodo Espejo de la Testnet de Hedera. El servidor se creó con FastMCP , un framework de TypeScript para crear servidores MCP. Utiliza esquemas Zod para la validación de entrada.

Características

• Integración de puntos finales : convierte automáticamente las API de nodo espejo de Hedera, definidas en formato de especificación OpenAPI, en herramientas compatibles con MCP.
• Compatibilidad con eventos enviados por el servidor (SSE) : los clientes no pueden conectarse a este servidor MCP a través del transporte SSE.
• Validación de esquema : garantiza que los parámetros de solicitud se adhieran a los esquemas definidos mediante Zod.

Prerrequisitos

Antes de ejecutar el servidor, asegúrese de tener instalado lo siguiente:

• Bun , o cualquier otro entorno capaz de ejecutar Typescript directamente.

Instalación

(1) Clonar el repositorio

(2) Navegue hasta el directorio del proyecto

(3) Instalar dependencias

Uso

Para iniciar el servidor MCP:

Tras un inicio exitoso, debería ver:

Se podrá acceder al servidor a través del punto final SSE configurado.

http://localhost:3333/hedera-testnet-mirror-node-api/sse

Estructura del proyecto

• mcpServer.ts : el punto de entrada que inicializa e inicia el servidor MCP.
• openApiZod.ts : contiene definiciones de puntos finales de API de nodo espejo y un cliente de API que utiliza zodios (como axios aumentado con definiciones de esquema zod ).
  • Tenga en cuenta que este archivo se generó programáticamente utilizando openapi-zod-client más algunas modificaciones manuales.

Cómo funciona

(1) Creación de cliente API

Se crea un cliente API para el nodo espejo de la red de pruebas de Hedera mediante la función createApiClient . El servidor MCP actúa como proxy entre este cliente API HTTP y su propio transporte SSE.

(2) Conversión de puntos finales:

Cada definición de punto final de endpointDefinitions es procesada por la función convertZodiosToMcp , que:

• Valida que el punto final utilice el método GET .
• Asigna parámetros a esquemas Zod.
• Define una función de ejecución que realiza la llamada API correspondiente y devuelve el resultado.
• Registra la herramienta con el servidor MCP.

(3) Inicialización del servidor:

El servidor MCP se inicia con el transporte SSE.

Dependencias

• FastMCP : Marco para crear servidores MCP.
• Zod : biblioteca de declaración y validación de esquemas basada en TypeScript.
• openapi-zod-client : genera código Zodios a partir de un archivo de especificación OpenAPI.

Autor

Brendan Graetz

Licencia

Instituto Tecnológico de Massachusetts (MIT)