agentis-dev/Solana-Analytics-MCP

Solana Analytics MCP

A powerful Model Context Protocol (MCP) server providing real-time Solana blockchain analytics, DeFi insights, and investment intelligence through Claude Desktop.

🚀 Overview

Solana Analytics MCP delivers comprehensive blockchain intelligence by aggregating data from multiple sources including Solana RPC endpoints, DeFi protocols, social media platforms, and security audit databases. This system provides real-time analytics for tokens, DeFi protocols, whale activity, market trends, and investment risk assessment.

✨ Key Features

🔍 Token Discovery & Analysis

• Real-time Token Discovery: Identify emerging tokens with high growth potential
• Multi-factor Scoring: Advanced algorithms analyzing volume, liquidity, holder distribution
• Performance Metrics: Comprehensive token performance tracking and evaluation

💭 Social Sentiment Analysis

• Multi-platform Monitoring: Twitter, Reddit, Telegram, Discord sentiment tracking
• AI-powered Analysis: Advanced sentiment scoring with confidence intervals
• Community Insights: Real-time community engagement and buzz metrics

🐋 Whale Activity Monitoring

• Institutional Tracking: Monitor large wallet movements and institutional activity
• Transaction Analysis: Real-time tracking of significant transactions
• Market Impact Assessment: Analyze the effect of whale movements on market dynamics

🏦 DeFi Protocol Intelligence

• Protocol Scanning: Comprehensive analysis of DeFi protocols across Solana
• TVL Tracking: Real-time Total Value Locked monitoring and trends
• Yield Optimization: APY analysis and yield farming opportunities
• Risk Assessment: Protocol security and investment risk evaluation

📈 Market Trend Detection

• AI-powered Insights: Advanced algorithms for trend identification
• Sector Analysis: Emerging sectors and investment themes
• Market Sentiment: Overall market mood and direction indicators
• Risk Monitoring: Market-wide risk factors and warning signals

⚠️ Investment Risk Assessment

• Multi-factor Analysis: Smart contract, liquidity, market, and team risk evaluation
• Security Audits: Integration with security audit databases
• Risk Scoring: Comprehensive risk scores with actionable recommendations
• Mitigation Strategies: Targeted risk reduction recommendations

💼 Portfolio Optimization

• Portfolio Analysis: Complete wallet and portfolio evaluation
• Optimization Strategies: Goal-based portfolio optimization recommendations
• Rebalancing Suggestions: Automated portfolio rebalancing recommendations
• Performance Tracking: Historical and real-time portfolio performance metrics

🛠 Installation & Setup

Prerequisites

• Node.js 18+ and npm
• Claude Desktop application
• Solana RPC endpoint access (mainnet)

Quick Setup

1. Clone and Install

   git clone <repository-url>
   cd solana-analytics-mcp
   npm install
   

2. Environment Configuration

   cp env.example .env
   # Configure your API keys and endpoints in .env
   

3. Build the Project

   npm run build
   

4. Initialize the System

   npm run initialize
   

5. Test All Functions

   npm run test
   

🔧 Configuration

Environment Variables

Create a .env file with your configuration:

# Solana Network Configuration
SOLANA_RPC_URL=https://api.mainnet-beta.solana.com
SOLANA_WSS_URL=wss://api.mainnet-beta.solana.com

# API Keys (Optional but recommended)
TWITTER_API_KEY=your_twitter_api_key
REDDIT_API_KEY=your_reddit_api_key
COINGECKO_API_KEY=your_coingecko_api_key

# Database Configuration
DATABASE_URL=your_database_url

# Logging Level
LOG_LEVEL=info

# Cache Settings
CACHE_TTL=300

Claude Desktop Integration

Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "solana-analytics": {
      "command": "node",
      "args": ["path/to/solana-analytics-mcp/build/src/server.js"],
      "env": {
        "SOLANA_RPC_URL": "https://api.mainnet-beta.solana.com"
      }
    }
  }
}

📊 Available Tools

1. discover_emerging_tokens

Identify and analyze emerging tokens with high potential.

Parameters:

• minVolume (number): Minimum 24h trading volume filter
• maxAge (number): Maximum token age in days
• includeMetrics (boolean): Include detailed performance metrics

Example:

{
  "minVolume": 50000,
  "maxAge": 30,
  "includeMetrics": true
}

2. calculate_sentiment_score

Calculate comprehensive social sentiment scores with multi-platform analysis.

Parameters:

• tokenAddress (string, required): Solana token address to analyze
• includeSocial (boolean): Include social media metrics

Example:

{
  "tokenAddress": "So11111111111111111111111111111111111111112",
  "includeSocial": true
}

3. monitor_whale_activity

Monitor whale wallet movements and institutional activity patterns.

Parameters:

• timeframe (string): Analysis timeframe (1h, 4h, 24h, 7d)
• minTransactionSize (number): Minimum transaction size in USD
• includePortfolios (boolean): Include portfolio composition analysis

Example:

{
  "timeframe": "24h",
  "minTransactionSize": 100000,
  "includePortfolios": false
}

4. analyze_defi_protocols

Comprehensive DeFi protocol analysis with TVL, yield, and risk assessment.

Parameters:

• protocolTypes (array): Filter by protocol types (dex, lending, staking, yield_farming)
• minTVL (number): Minimum Total Value Locked filter

Example:

{
  "protocolTypes": ["dex", "lending"],
  "minTVL": 1000000
}

5. detect_market_trends

AI-powered market trend detection with sentiment and risk analysis.

Parameters:

• analysisDepth (string): Depth of analysis (surface, detailed, comprehensive)
• sectors (array): Focus on specific sectors (defi, gaming, ai, infrastructure)

Example:

{
  "analysisDepth": "detailed",
  "sectors": ["defi", "gaming"]
}

6. assess_investment_risks

Multi-factor investment risk assessment with mitigation strategies.

Parameters:

• targetAddress (string, required): Target token/protocol address
• investmentAmount (number): Planned investment amount in USD
• riskFactors (array): Specific risk factors to analyze

Example:

{
  "targetAddress": "675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8",
  "investmentAmount": 10000,
  "riskFactors": ["liquidity", "smart_contract", "team", "market"]
}

7. generate_portfolio_insights

Generate portfolio optimization insights with risk-adjusted recommendations.

Parameters:

• walletAddress (string, required): Wallet address to analyze
• optimizationGoal (string): Portfolio objective (growth, yield, balanced, conservative)
• includeRebalancing (boolean): Include rebalancing recommendations

Example:

{
  "walletAddress": "5Q544fKrFoe6tsEbD7S8EmxGTJYAKtTVhAW5Q5pge4j1",
  "optimizationGoal": "balanced",
  "includeRebalancing": true
}

📈 Usage Examples

Basic Token Analysis

Can you analyze the sentiment and risk profile for SOL token?

DeFi Protocol Comparison

Compare the top DeFi lending protocols on Solana by TVL, APY, and risk factors.

Market Trend Analysis

What are the emerging trends in the Solana ecosystem right now? Focus on DeFi and gaming sectors.

Whale Activity Monitoring

Show me the largest whale transactions in the past 24 hours and their potential market impact.

Portfolio Optimization

Analyze my wallet portfolio and suggest optimizations for balanced growth with moderate risk.

Investment Risk Assessment

I want to invest $50,000 in Raydium. Can you assess the risks and provide mitigation strategies?

🏗 Architecture

Core Components

Analytics Engine (src/core/analytics.ts)

• Real-time Data Processing: Direct Solana blockchain data access
• Multi-source Aggregation: Combines on-chain and off-chain data sources
• Caching Layer: Optimized data retrieval with intelligent caching
• Error Handling: Robust error handling with fallback mechanisms

Specialized Analyzers

1. Token Analyzer (src/analyzers/tokenAnalyzer.ts)

   • Token discovery algorithms
   • Performance scoring and ranking
   • Liquidity and volume analysis

2. Wallet Tracker (src/analyzers/walletTracker.ts)

   • Whale wallet identification and monitoring
   • Transaction pattern analysis
   • Portfolio composition tracking

3. DeFi Scanner (src/analyzers/defiScanner.ts)

   • Protocol TVL tracking and analysis
   • Yield farming opportunity identification
   • Protocol risk assessment

4. Trend Detector (src/analyzers/trendDetector.ts)

   • Market trend identification using AI
   • Social sentiment aggregation
   • Sector analysis and emerging themes

5. Risk Assessment (src/analyzers/riskAssessment.ts)

   • Multi-factor risk analysis
   • Security audit integration
   • Investment recommendation engine

Data Sources

• Solana RPC Mainnet: Real-time blockchain data
• DeFiLlama API: Protocol TVL and analytics
• Social Media APIs: Twitter, Reddit sentiment data
• Security Audit Databases: Certik, Halborn, OtterSec
• Price Feeds: CoinGecko, Jupiter aggregated pricing

Project Scripts

Development

npm run dev          # Start development server
npm run build        # Build the project
npm run type-check   # Run TypeScript checks

Testing & Validation

npm run test         # Run all function tests
npm run test:performance  # Performance benchmarking
npm run test:stress  # Stress testing
npm run initialize   # System initialization

Production

npm start           # Start production server
npm run health      # Health check

🔒 Security & Privacy

• No Private Key Storage: System operates with read-only access
• Rate Limiting: Built-in rate limiting for API calls
• Data Encryption: Sensitive data encrypted in transit and at rest
• Audit Trail: Complete logging of all analytics operations

🚀 Performance

• Sub-second Response Times: Optimized for rapid data retrieval
• Concurrent Processing: Handles multiple simultaneous requests
• Intelligent Caching: Reduces API calls while maintaining data freshness
• Scalable Architecture: Designed for high-throughput operations

🔧 Troubleshooting

Common Issues

1. Connection Timeout

   • Verify Solana RPC endpoint availability
   • Check network connectivity
   • Consider using alternative RPC providers

2. Rate Limiting

   • Implement appropriate delays between requests
   • Use API keys for higher rate limits
   • Configure caching for frequently accessed data

3. Data Inconsistencies

   • Verify data source availability
   • Check for network latency issues
   • Review cache invalidation settings

Performance Optimization

1. Cache Configuration

   CACHE_TTL=300  # 5 minutes for most data
   CACHE_TTL_LONG=3600  # 1 hour for static data
   

2. Connection Pooling

   MAX_CONNECTIONS=10
   CONNECTION_TIMEOUT=30000
   

📝 Contributing

We welcome contributions! Please see our contributing guidelines and code of conduct.

Development Setup

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests for new functionality
5. Ensure all tests pass
6. Submit a pull request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🤝 Support

• Documentation: Comprehensive guides and API references
• Issues: GitHub Issues for bug reports and feature requests
• Community: Join our Discord for community support

Solana Analytics MCP - Real-time blockchain intelligence for the modern investor.