Solana Metrics MCP Server

Analiza métricas de Solana desde InfluxDB y genera paneles de Grafana.

GitHub
2
Prueba este MCPPatrocinado

Documentación

Servidor MCP de Métricas de Solana

Este servidor MCP analiza métricas de Solana desde InfluxDB y genera paneles de Grafana. Está diseñado para trabajar con la base de datos sol_metrics y proporciona categorización inteligente y análisis de métricas de blockchain.

Características

  • 🔍 Descubrimiento de Métricas: Lista todas las métricas disponibles de la base de datos sol_metrics de InfluxDB
  • 🏷️ Categorización Inteligente: Categoriza automáticamente las métricas en grupos lógicos (Consenso, Red, Banca, Cuentas, RPC, Rendimiento, Jito/MEV)
  • 📊 Análisis de Métricas: Proporciona explicaciones detalladas de qué mide cada métrica y por qué es útil
  • 📁 Exportación Automática de Paneles: Crea y guarda archivos JSON de paneles de Grafana importables en la carpeta grafana/
  • 🔎 Búsqueda de Código: Ayuda a localizar definiciones de métricas en el código fuente de Solana en Rust
  • 🔄 Soporte Dual de InfluxDB: Compatible con InfluxDB v1 y v2
  • 🛠️ Integración con VS Code: Funciona perfectamente como servidor MCP en Visual Studio Code

Instalación

npm install
npm run build

Configuración

Establece las siguientes variables de entorno para conectarte a tu instancia de InfluxDB:

export INFLUX_URL="http://your-influxdb-server:8086"
export INFLUX_TOKEN="your_token"
export INFLUX_ORG="your_org"
export INFLUX_BUCKET="sol_metrics"
export INFLUX_VERSION="v1"  # or "v2" for InfluxDB v2

Exportación de Paneles

Cuando generas paneles usando la herramienta generate_dashboard, el servidor automáticamente:

  1. Guarda archivos JSON en la carpeta grafana/ de tu directorio de proyecto
  2. Crea copias de seguridad con marca de tiempo para el historial de versiones
  3. Proporciona configuraciones de paneles de Grafana listas para importar

Archivos de panel generados:

  • consensus-dashboard.json - Recompensas de época, confirmación de slots, votación de validadores
  • network-dashboard.json - Gossip, información del clúster, métricas de retransmisión
  • banking-dashboard.json - Procesamiento de transacciones, tarifas de priorización
  • accounts-dashboard.json - Base de datos de cuentas, caché, métricas de hash
  • rpc-dashboard.json - Métricas del servicio RPC y suscripciones
  • performance-dashboard.json - Métricas de uso de CPU, memoria y disco
  • jito-mev-dashboard.json - Motor de bloques, procesamiento de paquetes, métricas de relayer MEV

Uso con Claude Desktop

Añade este servidor a tu configuración de Claude Desktop:

{
  "mcpServers": {
    "solana-metrics": {
      "command": "node",
      "args": ["/absolute/path/to/solana-metrics-mcp-server/build/index.js"]
    }
  }
}

Herramientas Disponibles

1. list_metrics

Lista todas las métricas disponibles de la base de datos sol_metrics.

2. analyze_metrics

Analiza y categoriza métricas con explicaciones detalladas.

  • Parámetros:
    • category (opcional): Filtrar por categoría (Consenso, Red, Banca, Cuentas, RPC, Rendimiento, Jito/MEV, Otro, Todas)

3. generate_dashboard

Genera un JSON de panel de Grafana para métricas seleccionadas.

  • Parámetros:
    • category: Categoría para la cual generar el panel
    • dashboard_name: Nombre para el panel generado

4. search_rust_code

Busca definiciones de métricas en el código fuente de Solana en Rust.

  • Parámetros:
    • metric_name: Nombre de la métrica a buscar

Categorías de Métricas

El servidor organiza las métricas en las siguientes categorías basadas en la arquitectura de Solana:

  • Consenso: Votación de validadores, slots, épocas, programaciones de líderes
  • Red: Topología del clúster, gossip, turbine, TPU/TVU, reparaciones
  • Banca: Procesamiento de transacciones, registro PoH, utilización de slots de líder
  • Cuentas: Operaciones de base de datos de cuentas, hash, instantáneas
  • RPC: Manejo de solicitudes de API, suscripciones, conexiones WebSocket
  • Rendimiento: Recursos del sistema, benchmarks de rendimiento
  • Jito/MEV: Propinas MEV, procesamiento de paquetes, métricas del motor de bloques

Desarrollo

# Development mode
npm run dev

# Build only
npm run build

# Start server
npm start

Contribuciones

Este servidor está diseñado para el análisis de métricas de Solana. Para preguntas o mejoras, consulta la documentación de métricas de Solana y el código fuente.