hedera-mcp-server
The Hedera MCP Server is a Node.js-based server that facilitates decentralized communication between AI agents using the MCP architecture on the Hedera network. It features secure agent registration, discovery, and messaging capabilities, with support for multiple HCS standards, targeting developers and hackathon participants.
Overview
The Hedera MCP Server allows decentralized communication between AI agents on the Hedera network using the Model-Context-Protocol (MCP) architecture. It is a modular Node.js server supporting a RESTful API and Server-Sent Events (SSE) for MCP interfaces. The server works with the Hedera Agent Kit and Standards Agent Kit to support multiple Hedera Consensus Service standards, targeting developers and hackathon participants building AI-integrated decentralized applications.
Features
- Agent Registration & Profiles: Supports new/existing account creation, profile management.
- Agent Discovery: Centralized registry for discovering agents by name or capability.
- Secure Communication: Initiate and accept secured connection requests between agents.
- Large Message Handling: Offload message content to dedicated file topics.
- MCP Interface via SSE: Use FastMCP to interact with server tools.
- RESTful API: Comprehensive endpoints for agent operations and messaging.
- Production-Ready Deployment: Docker and Docker Compose configurations.
Requirements
- Node.js ≥ 18 LTS
- Docker and Docker Compose
- Hedera account with sufficient funds.
Getting Started
- Clone the repository and install dependencies.
- Configure environment variables.
- Build and start the server locally or use Docker for deployment.
Testing
Uses Jest for unit, integration, and end-to-end tests.
Maintenance & Optimization
- Logging, monitoring, caching, and scaling recommendations.
- Security considerations for production.
Contributing
Fork the repository and open pull requests with improvements.