anoop04singh/hyperMCP-ethonline

HyperMCP

Built by @0xanoop for the Envio AI + Tooling Hackathon at ETHONLINE

Overview

HyperMCP is a Model Context Protocol (MCP) server that integrates Envio's blockchain indexing capabilities directly into AI assistants such as Claude Desktop. It offers 35+ intelligent tools for developers to build, query, and manage blockchain indexers using natural language.

read the deatiled guide at: HyperMCP: Building Blockchain Indexers Through Conversations

What is Envio?

Envio provides high-performance blockchain data infrastructure through:

What is MCP?

The Model Context Protocol (MCP) allows AI assistants to securely connect with external data sources and tools. HyperMCP implements this protocol to make Envio’s stack accessible via conversational AI.

Features

HyperMCP provides specialized tools across four categories:

1. HyperIndex Tools (Code Generation)

• Project structure generation

• Config.yaml creation

• Schema.graphql generation

• TypeScript handler templates

• Multi-chain setup

• Dynamic contract patterns

• Validation and optimization

2. HyperSync Tools (Data Queries)

• Event log queries across 70+ networks

• Transaction lookups

• Real-time event streaming

• Custom query building

• Network endpoint discovery

3. Documentation Tools

• Semantic search across all Envio docs

• Code example retrieval

• Config reference lookup

• Error troubleshooting

4. Configuration Tools

• Template generation

• Network addition

• Contract management

• Validation helpers

Quick Start

Prerequisites

• Node.js 18+
• npm or pnpm
• Claude Desktop app
• Envio CLI (optional for full functionality)

Installation

git clone https://github.com/anoop04singh/hyperMCP-ethonline
cd hyperMCP-ethonline
npm install
npm run build

Install Envio CLI (optional but recommended):

npm install -g envio

Get a HyperSync API Token from envio.dev/app/api-tokens

Connect to Claude Desktop

Step 1: Locate Config File

Step 2: Add HyperMCP Configuration

{
  "mcpServers": {
    "hypermcp": {
      "command": "node",
      "args": ["/absolute/path/to/hypermcp/dist/index.js"],
      "env": {
        "HYPERSYNC_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

Replace /absolute/path/to/hypermcp with your actual project path.

Step 3: Restart Claude Desktop

• Press Ctrl+R (Windows/Linux) or Cmd+R (macOS)
• Or quit and reopen the app

Step 4: Verify Connection

Click the tools icon in Claude’s interface. If you see 35+ HyperMCP tools, you’re ready to go.

Usage Examples

Example 1: Create USDC Indexer on Base

You say:

"Help me create an indexer for USDC transfers on Base, starting from block 10000000."

Claude will:

• Import USDC contract via explorer
• Generate transfer event handler
• Validate configuration
• Provide setup instructions

Example 2: Query Recent Uniswap V3 Swaps

You say:

"Show me the last 10 Uniswap V3 swaps on Ethereum with amounts and prices."

Claude will:

• Get Ethereum endpoint
• Query swap events
• Decode and format results with transaction details

Example 3: Multi-Chain NFT Indexer

You say:

"Set up an indexer for Bored Ape Yacht Club transfers on Ethereum and Base."

Claude will:

• Import contracts for both chains
• Configure multi-chain template
• Generate Transfer handlers
• Enable unordered multi-chain mode

Example 4: Debug Configuration

You say:

"My config.yaml isn’t working. Can you check what’s wrong?"

Claude will:

• Validate the config file
• Diagnose errors
• Suggest exact fixes

Available Tools

HyperIndex Commands

HyperSync Commands

Documentation Commands

Configuration Commands

Project Structure

hypermcp/
├── src/
│   ├── index.ts                 # Main MCP server
│   ├── tools/
│   │   ├── hyperindex.ts        # HyperIndex CLI tools
│   │   ├── hypersync.ts         # HyperSync tools
│   │   ├── documentation.ts     # Documentation tools
│   │   └── config.ts            # Config tools
│   └── utils/
│       ├── networks.ts          # Network config
│       ├── validators.ts        # Validation logic
│       ├── templates.ts         # Code templates
│       ├── errors.ts            # Error handling
│       └── constants.ts         # Constants
├── dist/                        # Compiled JS
├── package.json
├── tsconfig.json
└── README.md

Architecture

┌─────────────────┐
│  Claude Desktop │
│   (AI Assistant)│
└────────┬────────┘
         │  MCP Protocol
         ▼
┌─────────────────┐
│    HyperMCP     │
│    MCP Server   │
└────────┬────────┘
         │
    ┌────┼────┐
    ▼    ▼    ▼
┌───────┐ ┌──────┐ ┌──────┐
│ Envio │ │ Sync │ │ Docs │
│  CLI  │ │ Tool │ │ API  │
└───────┘ └──────┘ └──────┘

Testing

Manual

node dist/index.js

Expected output:

Envio MCP Server running on stdio

Using MCP Inspector

npx @modelcontextprotocol/inspector node dist/index.js

This opens a UI to:

• View all available tools
• Test functions interactively
• Inspect requests and responses

Debugging

Check Logs

macOS:

tail -f ~/Library/Logs/Claude/mcp*.log

Windows:

type %APPDATA%\Claude\logs\mcp*.log

Common Issues

Key Benefits

• Natural Language Interface
• Instant Documentation Access
• Error Prevention and Validation
• Automatic Code Generation
• Multi-Chain Compatibility
• Real-Time Blockchain Queries
• Template-Based Setup
• Best-Practice Recommendations

Links

• Envio Documentation
• HyperSync Explorer
• Model Context Protocol
• Envio Discord
• GitHub Repository

Roadmap

• Add support for Fuel blockchain indexing
• Implement GraphQL query builder
• Add subgraph migration tools
• Create visual config editor
• Add deployment to hosted service
• Enable real-time sync monitoring
• Add custom RPC endpoint support
• Provide example templates

Stats

Built by @0xanoop for the Envio AI + Tooling Hackathon