系统诊断MCP服务器

一个Rust编写的MCP服务器,实时暴露CPU、RAM、进程和端口信息给AI代理,如Claude、Cursor等,避免AI代理盲目执行代码。

  • by DaniluxGz
  • Rust
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 DaniluxGz/mcp-sys

使用说明

mcp-sys——用于系统诊断的mcp服务器

一个Rust MCP服务器,向任何AI代理(Claude、Cursor、Windsurf、Continue.dev等)公开实时CPU、RAM、进程和端口。

演示

它做什么

人工智能聊天机器人不执行代码,但现代人工智能代理可以。它们可以直接在你的机器上运行命令。问题是:他们盲目地这样做,将代码注入到您的终端中搜索他们需要的东西,有时会命中他们不应该接触的进程、端口或数据。

mcp-sys修复了这个问题 --它为Claude和任何AI代理提供了安全、即时、实时的操作系统状态可见性。没有盲目的探查,没有不必要的处决。

使用mcp系统

Dev: "Why isn't my server starting on port 3000?"
Claude calls mcp-sys →
"Port 3000 is taken by node.exe (PID 14821).
 RAM is at 89% — Chrome is the heaviest process.
 Want me to help free up resources?"

为什么这对代理AI很重要: 当AI代理直接在您的机器上执行代码时,它需要真实的系统上下文才能安全地运行。mcpsys提供了这种上下文——防止可能影响正在运行的进程、占用的端口或过载系统的盲目决策。


为什么是Rust?

  • 单个二进制 --一个 .exe,无运行时,无需安装依赖项
  • 本地性能 --以最小的开销读取CPU、RAM和端口
  • 内存安全 --没有崩溃,没有泄漏,在后台安静运行
  • 跨平台核心 --Windows今天,Linux和macOS准备好v0.3

安装

1.下载

从 最新版本 --没有依赖关系。没有安装程序。只需一个二进制文件——下载并运行。

🦀 Rust开发者? 从源代码构建:

git clone https://github.com/DaniluxGz/mcp-sys
cd mcp-sys
cargo build --release

2.配置

将此添加到您的MCP客户端配置中:

{
  "mcpServers": {
    "mcp-sys": {
      "command": "/absolute/path/to/mcp-sys"
    }
  }
}

💡 不确定配置文件在哪里?问你的AI助手: “如何将MCP服务器添加到[客户端名称]?”

3.重新启动并继续

适用于Claude Desktop、Claude Code、Cursor、Windsurf、Continue.dev等。

⚠️ Windows注意事项: Windows可能会在首次运行时标记二进制文件。 点击 “更多信息”→ “无论如何都要运行” 继续。 这适用于未签名的开源二进制文件。


工具

工具 描述 返回
system_stats 当前系统状态快照 CPU%、已用RAM/总计、已用磁盘/总计
list_processes 正在运行的进程 PID、名称、CPU百分比、每个进程的RAM
list_ports 占用的端口 端口号、PID、进程名称

使用示例

调试端口冲突

You: "Why isn't my server starting on port 3000?"

Claude: Port 3000 is occupied by node.exe (PID 14821).
        RAM is at 89% — Chrome is the heaviest process (1.2GB).
        Want me to help free up resources?

在重型建筑之前

You: "Can I run a full Docker build right now?"

Claude: CPU 9% — RAM 61% — Disk 84%.
        Good to go, but consider cleaning disk first.

系统过载

You: "My machine feels sluggish."

Claude: Chrome is using 74% RAM. 3 Node processes running in background.
        Want me to help identify what to close?

意外的CPU峰值

You: "Something is hammering my CPU."

Claude: rust-analyzer at 94% CPU — likely indexing a large project.
        Should settle in a few minutes.

路线图

版本 状态 亮点
v0.1.0 ✅ 释放 system_stats, list_processes, list_ports
v0.2.0 🔧 正在进行中 过滤器, kill_process,自动化测试
v0.3.0 📅 计划中 公开发布,Scoop包,Linux支持

许可证

麻省理工学院——见 许可证 了解详情。