🚀 MegaETH Analytics MCP Server

A comprehensive Model Context Protocol (MCP) server that provides real-time analytics for the MegaETH blockchain. This server enables AI agents (like Claude Desktop) to query live blockchain data, analyze smart contracts, and provide deep insights into MegaETH's ultra-fast 10ms blockchain network.

✨ Features

🔍 Real-Time Network Analytics

Live TPS monitoring (1000+ transactions per second)
Gas price tracking and utilization metrics
Block time analysis leveraging MegaETH's 10ms mini-blocks
Transaction success rates and volume metrics

🏗️ Smart Contract Intelligence

Active contract discovery from live blockchain data
Contract interaction analysis with user metrics
Function call popularity and gas usage patterns
Contract type classification (ERC20, DEX, DeFi, etc.)
Deployment tracking with creator information

🐋 Advanced Analytics

Whale transaction detection with configurable thresholds
User behavior analysis and retention metrics
DeFi protocol monitoring (DEX, lending, yield farming)
Cross-contract interaction patterns

🤖 AI Integration

Claude Desktop compatible via MCP protocol
6 specialized tools for blockchain analysis
Natural language queries about blockchain data
RESTful API for external integrations

🚀 Quick Start

Prerequisites

Node.js 18.0.0 or higher
npm or yarn package manager
Access to MegaETH RPC endpoint

Installation

# Clone the repository
git clone https://github.com/RaveniumNFT/megaeth-analytics-mcp.git
cd megaeth-analytics-mcp

# Install dependencies
npm install

# Copy environment configuration
cp .env.example .env

# Edit configuration
nano .env

Environment Configuration

# MegaETH Network
MEGAETH_RPC_URL=https://carrot.megaeth.com/rpc
MEGAETH_WS_URL=wss://carrot.megaeth.com/rpc

# Database (SQLite for development)
DB_HOST=localhost
DB_PORT=5432
DB_NAME=megaeth_analytics
DB_USER=postgres
DB_PASSWORD=your_password

# Server Configuration
API_PORT=3000
LOG_LEVEL=info
MCP_MODE=false

Development Setup

# Start development server
npm run dev

# Build for production
npm run build

# Start production server
npm start

Testing the API

# Test network statistics
curl http://localhost:3000/api/stats

# Test active contracts
curl http://localhost:3000/api/contracts

# Test function analysis
curl http://localhost:3000/api/contracts/functions

# Test ecosystem overview
curl http://localhost:3000/api/contracts/ecosystem

🤖 Claude Desktop Integration

Setup MCP Server

Install Claude Desktop from claude.ai/download
Configure MCP Server - Add to your Claude Desktop config:

Windows: %APPDATA%\Claude\claude_desktop_config.json Mac: ~/Library/Application Support/Claude/claude_desktop_config.json Linux: ~/.config/claude-desktop/claude_desktop_config.json

{
  "mcpServers": {
    "megaeth-analytics": {
      "command": "node",
      "args": ["/path/to/megaeth-analytics-mcp/dist/index.js"],
      "env": {
        "MCP_MODE": "true",
        "LOG_LEVEL": "error",
        "MEGAETH_RPC_URL": "https://carrot.megaeth.com/rpc"
      }
    }
  }
}

Restart Claude Desktop
Test Integration - Ask Claude:
- "What is the current MegaETH network performance?"
- "Show me the most active smart contracts on MegaETH"
- "Analyze recent transaction patterns"
- "What functions are being called most on MegaETH?"

🛠️ Available MCP Tools

Tool	Description	Parameters
`get_network_stats`	Real-time network statistics	`timeframe`: 1m, 5m, 1h, 24h
`analyze_transactions`	Transaction pattern analysis	`limit`, `contract_address`
`get_active_contracts`	Most active smart contracts	`limit`, `timeframe`
`detect_whales`	Large transaction detection	`threshold`, `timeframe`
`get_user_behavior`	User behavior analytics	`address`, `metric`
`monitor_defi_activity`	DeFi protocol monitoring	`protocol_type`, `timeframe`

📊 API Endpoints

Network Analytics

GET /api/stats - Network statistics
GET /api/stats?timeframe=1h - Stats for specific timeframe

Smart Contracts

GET /api/contracts - Active contracts list
GET /api/contracts/functions - Popular function analysis
GET /api/contracts/types - Contract type distribution
GET /api/contracts/deployments - Recent deployments
GET /api/contracts/ecosystem - Ecosystem overview

Advanced Analytics

GET /api/whales - Whale transaction detection
GET /api/users - User behavior analysis
GET /api/defi - DeFi activity monitoring

🏗️ Architecture

┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
│   Claude AI     │    │   MCP Server     │    │   MegaETH RPC   │
│                 │◄──►│                  │◄──►│                 │
│ Natural Language│    │ Analytics Engine │    │ Blockchain Data │
└─────────────────┘    └──────────────────┘    └─────────────────┘
                                │
                                ▼
                       ┌──────────────────┐
                       │   SQLite DB      │
                       │ Contract Cache   │
                       └──────────────────┘

Key Components

MCP Server: Implements Model Context Protocol for AI integration
Analytics Engine: Processes and analyzes blockchain data
Contract Analyzer: Discovers and categorizes smart contracts
Database Layer: Caches contract data and analytics
API Server: RESTful endpoints for external integrations

🤝 Contributing

I am open contributions to improve MegaETH Analytics! Here's how you can help:

🟢 What You CAN Do

Submit bug reports with detailed reproduction steps
Propose new features via GitHub issues
Improve documentation and code comments
Add new analytics methods for contract analysis
Enhance MCP tool functionality
Add support for new contract types
Optimize performance and reduce API calls
Add tests for existing functionality

🔴 What You CANNOT Do

Redistribute this software under a different license
Remove copyright notices or attribution
Use the codebase for commercial products without permission
Create competing services using this codebase
Modify license terms or claim ownership

Contribution Process

Fork the repository
Create a feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

Code Standards

TypeScript for type safety
ESLint for code quality
Prettier for formatting
Conventional commits for clear history
Comprehensive comments for complex logic

📈 Performance & Limitations

Performance Characteristics

Processes 1000+ TPS from MegaETH network
Sub-second response times for cached data
10ms latency for real-time mini-block data
Efficient rate limiting to respect RPC endpoints

Current Limitations

Testnet only - Mainnet support coming soon
Rate limited by MegaETH RPC endpoints
Contract analysis limited to recent blocks
Historical data requires additional storage

🔧 Advanced Configuration

Database Options

SQLite (Default - Development)

# No additional configuration needed

PostgreSQL (Production)

DB_HOST=localhost
DB_PORT=5432
DB_NAME=megaeth_analytics
DB_USER=postgres
DB_PASSWORD=your_secure_password

Logging Configuration

LOG_LEVEL=info  # error, warn, info, debug

MCP Mode

MCP_MODE=true   # Disables console logging for Claude Desktop

🚀 Deployment

Docker Deployment

# Build Docker image
docker build -t megaeth-analytics .

# Run container
docker run -p 3000:3000 -e MEGAETH_RPC_URL=https://carrot.megaeth.com/rpc megaeth-analytics

Production Deployment

Build the application
```
npm run build
```

Set production environment

export NODE_ENV=production
export MCP_MODE=false

Start the server
```
npm start
```

📊 Live Analytics Dashboard

For a complete analytics dashboard with beautiful visualizations, visit: MegaETH Analytics Dashboard

🤖 Example Claude Interactions

Human: What's the current MegaETH network performance?

Claude: Based on the latest MegaETH analytics:

📊 **Network Performance (Real-time)**
• Current TPS: 1,089 transactions per second
• Block Time: 24ms (ultra-fast!)
• Gas Usage: 3% utilization
• Success Rate: 100%

The network is performing exceptionally well with:
- 983 transactions in the latest block
- 100% contract call activity (active ecosystem)
- Minimal gas costs due to low congestion

MegaETH's 10ms mini-blocks enable this incredible throughput!

📄 License & Rights

Copyright & Ownership

Original work created for the MegaETH ecosystem
Commercial use requires explicit permission

MIT License

MIT License

Copyright (c) 2025 RaveniumNFT

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

🙏 Acknowledgments

MegaETH Team for building an incredible 10ms blockchain
Anthropic for the Model Context Protocol specification
Claude AI for enabling natural language blockchain analysis
Open source community for the amazing tools and libraries

📞 Support & Contact

GitHub Issues: Report bugs or request features
Twitter: @RaveniumNFT

Built with ❤️ for the MegaETH ecosystem

Empowering AI agents with real-time blockchain intelligence

Name		Name	Last commit message	Last commit date
.github		.github
examples		examples
src		src
.env.example		.env.example
CONTRIBUTING.md		CONTRIBUTING.md
Dockerfile		Dockerfile
LICENSE file (MIT)		LICENSE file (MIT)
README.md		README.md
claude-prompts.md		claude-prompts.md
claude_desktop_config.json		claude_desktop_config.json
package-lock.json		package-lock.json
package.json		package.json
temp-tools-fix.js		temp-tools-fix.js
test-connection.js		test-connection.js
test-mcp-protocol.js		test-mcp-protocol.js
tsconfig.json		tsconfig.json

Latest commit

History

Folders and files

Repository files navigation