DM

dmitriimaksimovdevelop/melisai

开发工具

本页由 AI 翻译,技术细节请以原文为准。 查看原文

66 stars 6 forks 质量 72 趋势 18Apache-2.0

通过eBPF/BCC实现的单二进制Linux性能诊断,专为人类和AI代理(MCP)构建

概览

开发暂停——近期内没有新功能、修复或新版本的计划。现有代码保持原样。Разработка приостановлена — новые функции, исправления и релизы в обозримом будущем не планируются.Существующий код остаётся доступным как есть. Melisai 在 10 秒内回答了这个问题。单一 Go 二进制——没有代理,没有守护进程,没有配置文件。它运行 67 个 BCC/eBPF 工具 + 8 个程序收集器,检测 37 个异常,计算健康评分,并准确告诉你需要更改哪个系统。可独立运行,也可以作为 Claude/Cursor 的 MCP 服务器,交互式诊断服务器。 一个命令。60秒。这是Melisai在生产Docker主机(8 CPU,32GB 内存,HDD RAID)上发现的情况: 根本原因链——硬盘延迟(p99=49ms)导致页面回收压力(PruneCalled=105),导致内核修剪TCP缓冲区,触发每秒31次重传,并在WireGuard隧道中串联处理了226K丢弃的数据包。

概述(AI 翻译)

[!警告] ** 🧊 项目无限期冻结。** 开发暂停——近期内无新功能、修复或新版本计划。现有代码保持原样。

🧊 Проект заморожен на неизвестный срок. Разработка приостановлена — новые функции, исправления и релизы в обозримом будущем не планируются.Существующий код остаётся доступным как есть.

你的服务器很慢。你用SS登录。接下来怎么办?

Melisai 在 10 秒内回答了这个问题。单一 Go 二进制——没有代理,没有守护进程,没有配置文件。它运行 67 个 BCC/eBPF 工具 + 8 个程序收集器,检测 37 个异常,计算健康评分,并准确告诉你需要更改哪个系统。可独立运行,也可以作为 Claude/Cursor 的 MCP 服务器,交互式诊断服务器。


主要特色

特色 功能
健康评分 单个0-100数字。绿色/黄色/红色。AI代理用它来决定下一步
37 异常规则基于速率的检测(非累计计数器)。捕捉此刻正在发生的问题
35 条建议 复制粘贴 sysctl 命令并附有证据。

本页由 AI 翻译,技术细节请以原文为准。

README

以下为原文 README 节选,完整内容请查看原文。

melisai

[!WARNING] 🧊 Project frozen for an indefinite period. Development is paused — no new features, fixes, or releases are planned for the foreseeable future. The existing code remains available as-is.

🧊 Проект заморожен на неизвестный срок. Разработка приостановлена — новые функции, исправления и релизы в обозримом будущем не планируются. Существующий код остаётся доступным как есть.

Your server is slow. You SSH in. Now what?

melisai answers that question in 10 seconds. Single Go binary — no agents, no daemons, no config files. It runs 67 BCC/eBPF tools + 8 procfs collectors, detects 37 anomalies, computes a health score, and tells you exactly what sysctl to change. Works standalone or as an MCP server for Claude/Cursor to diagnose servers interactively.

$ sudo melisai collect --profile quick -o report.json

  melisai v0.4.1 | profile=quick | duration=10s

  Tier 1 (procfs)  ████████████████████████████████████████ 8/8   2.1s
  Tier 2 (BCC)     ████████████████████████████████████████ 4/4  10.3s

  Health Score:  68 / 100  ⚠️
  Anomalies:     cpu_utilization CRITICAL (98.7%)
                 load_average WARNING (3.2x CPUs)
  Recommendations: 2

  Report saved to report.json

Key Features

Feature What it does
Health Score Single 0-100 number. Green/yellow/red. AI agents use it to decide next steps
37 Anomaly Rules Rate-based detection (not cumulative counters). Catches problems happening right now
35 Recommendations Copy-paste sysctl commands with evidence. Each tagged as “fix” or “optimization”
67 BCC Tools ~84% of Brendan Gregg’s BPF toolkit. Histograms, events, stack traces
GPU/PCIe Topology Detects NVIDIA GPUs, maps PCI→NUMA, flags cross-NUMA GPU-NIC pairs (30-50% DMA penalty)
Page Reclaim Tracking Direct reclaim rate, compaction stalls, THP splits — the invisible latency killers
NUMA Analysis Per-node miss ratio, distance matrix, CPU mapping. Catches 30-50% latency penalties
Network Deep Dive Conntrack, softnet, IRQ distribution, accept queue depth, 30+ TCP/UDP sysctls
MCP Server Claude Desktop / Cursor connect over stdio. Interactive server diagnostics
Before/After Diff Compare two reports. See what improved, what regressed
Observer Effect Mitigation Two-phase collection: baselines first, then BCC tools. PID exclusion
在 GitHub 查看完整 README

安装

This server does not publish a one-line install command.

Open the repository installation guide 新手?先看 mcpskill.org 教程 →

配置

{ "mcpServers": { "melisai": { "command": "ssh", "args": ["root@your-server", "/usr/local/bin/melisai", "mcp"] } } }