Solana Metrics MCP Server

此MCP服务器分析来自InfluxDB的Solana指标，并生成Grafana仪表板。它设计用于与sol_metrics数据库配合工作，并提供区块链指标的智能分类和分析。

功能

• 🔍 指标发现：列出sol_metrics InfluxDB数据库中的所有可用指标
• 🏷️ 智能分类：自动将指标分类到逻辑组中（共识、网络、银行、账户、RPC、性能、Jito/MEV）
• 📊 指标分析：提供每个指标测量内容及其用途的详细解释
• 📁 自动仪表板导出：创建并保存可导入的Grafana仪表板JSON文件至grafana/文件夹
• 🔎 代码搜索：帮助在Solana Rust代码库中定位指标定义
• 🔄 双InfluxDB支持：兼容InfluxDB v1和v2
• 🛠️ VS Code集成：作为MCP服务器无缝集成于Visual Studio Code中

安装

npm install
npm run build

配置

设置以下环境变量以连接到您的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"  # 或 "v2" 对于InfluxDB v2

仪表板导出

当您使用generate_dashboard工具生成仪表板时，服务器会自动：

1. 将JSON文件保存到项目目录下的grafana/文件夹
2. 创建时间戳备份以记录版本历史
3. 提供可导入的Grafana仪表板配置

生成的仪表板文件：

• consensus-dashboard.json - 历元奖励、插槽确认、验证者投票
• network-dashboard.json - 流言传播、集群信息、重传指标
• banking-dashboard.json - 交易处理、优先费用
• accounts-dashboard.json - 账户数据库、缓存、哈希指标
• rpc-dashboard.json - RPC服务和订阅指标
• performance-dashboard.json - CPU、内存、磁盘使用指标
• jito-mev-dashboard.json - 区块引擎、捆绑处理、MEV中继器指标

使用Claude Desktop

将此服务器添加到您的Claude Desktop配置中：

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

可用工具

1. list_metrics

列出sol_metrics数据库中的所有可用指标。

2. analyze_metrics

分析并分类指标，附带详细解释。

• 参数：
  • category（可选）：按类别过滤（共识、网络、银行、账户、RPC、性能、Jito/MEV、其他、全部）

3. generate_dashboard

为选定的指标生成Grafana仪表板JSON。

• 参数：
  • category：要生成仪表板的类别
  • dashboard_name：生成的仪表板名称

4. search_rust_code

在Solana Rust代码库中搜索指标定义。

• 参数：
  • metric_name：要搜索的指标名称

指标类别

根据Solana架构，服务器将指标组织成以下类别：

• 共识：验证者投票、插槽、历元、领导者调度
• 网络：集群拓扑、流言传播、涡轮机、TPU/TVU、修复
• 银行：交易处理、PoH记录、领导者插槽利用率
• 账户：账户数据库操作、哈希、快照
• RPC：API请求处理、订阅、WebSocket连接
• 性能：系统资源、吞吐量基准测试
• Jito/MEV：MEV提示、捆绑处理、区块引擎指标

开发

# 开发模式
npm run dev

# 仅构建
npm run build

# 启动服务器
npm start

贡献

此服务器旨在进行Solana指标分析。如有疑问或改进，请参阅Solana指标文档和代码库。 </中文翻译>