Solana Metrics MCP Server

Servidor MCP de Métricas Solana

Este servidor MCP analisa métricas Solana do InfluxDB e gera dashboards Grafana. Ele foi projetado para funcionar com o banco de dados sol_metrics e fornece categorização inteligente e análise de métricas de blockchain.

Recursos

• 🔍 Descoberta de Métricas: Lista todas as métricas disponíveis no banco de dados sol_metrics do InfluxDB
• 🏷️ Categorização Inteligente: Categoriza automaticamente métricas em grupos lógicos (Consenso, Rede, Banking, Contas, RPC, Desempenho, Jito/MEV)
• 📊 Análise de Métricas: Fornece explicações detalhadas sobre o que cada métrica mede e por que é útil
• 📁 Exportação Automática de Dashboards: Cria e salva arquivos JSON de dashboard Grafana importáveis na pasta grafana/
• 🔎 Busca de Código: Ajuda a localizar definições de métricas no código-fonte Rust da Solana
• 🔄 Suporte Dual ao InfluxDB: Compatível com InfluxDB v1 e v2
• 🛠️ Integração com VS Code: Funciona perfeitamente como servidor MCP no Visual Studio Code

Instalação

npm install
npm run build

Configuração

Defina as seguintes variáveis de ambiente para conectar à sua instância do 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

Exportação de Dashboards

Quando você gera dashboards usando a ferramenta generate_dashboard, o servidor automaticamente:

1. Salva arquivos JSON na pasta grafana/ do seu diretório de projeto
2. Cria backups com carimbo de data/hora para histórico de versões
3. Fornece configurações de dashboard Grafana prontas para importação

Arquivos de dashboard gerados:

• consensus-dashboard.json - Recompensas de época, confirmação de slot, votação de validadores
• network-dashboard.json - Métricas de gossip, informações de cluster, retransmissão
• banking-dashboard.json - Processamento de transações, taxas de priorização
• accounts-dashboard.json - Banco de dados de contas, cache, métricas de hash
• rpc-dashboard.json - Métricas de serviço RPC e assinaturas
• performance-dashboard.json - Métricas de uso de CPU, memória e disco
• jito-mev-dashboard.json - Métricas de block engine, processamento de bundles e relayer MEV

Uso com Claude Desktop

Adicione este servidor à sua configuração do Claude Desktop:

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

Ferramentas Disponíveis

1. list_metrics

Lista todas as métricas disponíveis no banco de dados sol_metrics.

2. analyze_metrics

Analisa e categoriza métricas com explicações detalhadas.

• Parâmetros:
  • category (opcional): Filtrar por categoria (Consenso, Rede, Banking, Contas, RPC, Desempenho, Jito/MEV, Outros, Todos)

3. generate_dashboard

Gera um JSON de dashboard Grafana para métricas selecionadas.

• Parâmetros:
  • category: Categoria para gerar o dashboard
  • dashboard_name: Nome do dashboard gerado

4. search_rust_code

Busca definições de métricas no código-fonte Rust da Solana.

• Parâmetros:
  • metric_name: Nome da métrica a ser pesquisada

Categorias de Métricas

O servidor organiza as métricas nas seguintes categorias com base na arquitetura da Solana:

• Consenso: Votação de validadores, slots, épocas, agendamentos de líderes
• Rede: Topologia de cluster, gossip, turbine, TPU/TVU, reparos
• Banking: Processamento de transações, gravação PoH, utilização de slots de líder
• Contas: Operações do banco de dados de contas, hash, snapshots
• RPC: Tratamento de solicitações de API, assinaturas, conexões WebSocket
• Desempenho: Recursos do sistema, benchmarks de throughput
• Jito/MEV: Dicas MEV, processamento de bundles, métricas de block engine

Desenvolvimento

# Development mode
npm run dev

# Build only
npm run build

# Start server
npm start

Contribuição

Este servidor foi projetado para análise de métricas Solana. Para dúvidas ou melhorias, consulte a documentação de métricas da Solana e o código-fonte.