Hedera Testnet Mirror Node MCP Server
This repository contains a Model Context Protocol (MCP) server that interfaces with the Hedera Testnet Mirror Node API. The server is built using FastMCP, a TypeScript framework for creating MCP servers. It utilises Zod schemas for input validation.
Features
- Endpoint Integration: Automatically converts Hedera Mirror Node APIs, defined in OpenAPI specification format, into MCP-compatible tools.
- Server-Sent Events (SSE) Support: Clients cannot connect to this MCP server over the SSE transport.
- Schema Validation: Ensures request parameters adhere to defined schemas using Zod.
Prerequisites
Before running the server, ensure you have the following installed:
- Bun, or any other environment capable of running Typescript directly.
Installation
(1) Clone the repository
(2) Navigate to the project directory
(3) Install dependencies
Usage
To start the MCP server:
Upon successful startup, you should see:
The server will be accessible via the configured SSE endpoint.
http://localhost:3333/hedera-testnet-mirror-node-api/sse
Project Structure
mcpServer.ts
: The entry point that initializes and starts the MCP server.openApiZod.ts
: Contains Mirror Node API endpoint definitions and an API client usingzodios
(likeaxios
augmented withzod
schema definitions).- Note that this file has been programmatically generated using
openapi-zod-client
plus some manual modifications.
- Note that this file has been programmatically generated using
How It Works
(1) API Client Creation
An API client is created for the Hedera Testnet Mirror Node using the createApiClient
function.
The MCP server proxies between this HTTP API client and its own SSE transport.
(2) Endpoint Conversion:
Each endpoint definition from endpointDefinitions
is processed by the convertZodiosToMcp
function, which:
- Validates that the endpoint uses the
GET
method. - Maps parameters to Zod schemas.
- Defines an execution function that makes the corresponding API call and returns the result.
- Registers the tool with the MCP server.
(3) Server Initialization:
The MCP server is started with SSE transport.
Dependencies
- FastMCP: Framework for building MCP servers.
- Zod: TypeScript-first schema declaration and validation library.
- openapi-zod-client: Generates Zodios code from an OpenAPI specification file.
Author
Licence
MIT
This server cannot be installed
A server that interfaces with the Hedera Testnet Mirror Node API, converting its OpenAPI-defined endpoints into MCP-compatible tools that can be accessed over Server-Sent Events (SSE).
Related MCP Servers
- -securityAlicense-qualityThis tool creates a Model Context Protocol (MCP) server that acts as a proxy for any API that has an OpenAPI v3.1 specification. This allows you to use Claude Desktop to easily interact with both local and remote server APIs.Last updated -548514JavaScriptMIT License
- AsecurityAlicenseAqualityA TypeScript-based MCP server that enables testing of REST APIs through Cline. This tool allows you to test and interact with any REST API endpoints directly from your development environment.Last updated -11023JavaScriptMIT License
- -securityAlicense-qualityA Python-based MCP server that integrates OpenAPI-described REST APIs into MCP workflows, enabling dynamic exposure of API endpoints as MCP tools.Last updated -239PythonMIT License
- -securityAlicense-qualityAn MCP server that exposes HTTP methods defined in an OpenAPI specification as tools, enabling interaction with APIs via the Model Context Protocol.Last updated -2PythonMIT License