SystemMind 🖥️🧠（可译为“系统思维”或保持原样作为品牌/项目名）

Image

面向智能系统运营的通用操作系统管理MCP服务器

SystemMind 是一个MCP（模型上下文协议）服务器，为AI助手提供强大的跨平台系统管理功能。它支持通过自然语言交互，在Windows、macOS和Linux操作系统之间实现无缝的监控、诊断和分析。

🎯 什么是SystemMind？

SystemMind填补了AI助手（如Claude）与操作系统之间的鸿沟，让您能够通过对话界面监控、诊断和优化您的计算机。它是一个可在多个操作系统上运行的统一API，提供实时洞察和诊断功能。

🔥 它解决的问题

挑战

现代计算机用户和管理员经常面临这些问题：

平台碎片化针对Windows、macOS和Linux的不同命令和工具
复杂的诊断浏览多个系统实用程序以识别问题
性能可见性难以快速了解系统资源使用情况
手动故障排除耗时的手动检查系统健康状况和瓶颈问题
上下文切换在任务管理器、活动监视器、top命令以及各种命令行界面（CLI）工具之间切换
技术壁垒非技术用户难以应对命令行诊断

解决方案

SystemMind提供：

统一界面 在Windows、macOS和Linux上均适用
人工智能辅助诊断 通过自然语言查询
实时监控 带有易于解析的指标
自动化性能分析 用于解决系统问题
单一入口点 对于所有操作系统操作
用户友好的输出 以简单的方式解释技术概念

🚀 特点

多平台支持

✅ Windows - 完全支持Windows 10/11
✅ macOS（苹果电脑操作系统） - 完全兼容 macOS
✅ Linux - Ubuntu、Debian、RHEL、CentOS 及其他发行版
🔄 旋转箭头（表示循环、重复或刷新等含义） 自动检测 - 自动检测操作系统并相应调整
🔌（电源插头/插座） 可插拔架构 - 所有平台间一致的API

综合系统运营

📊 系统信息

完整的硬件规格（CPU、RAM、存储）
操作系统详情及架构
当前的资源利用率指标
系统运行时间和启动时间

🔍 进程管理

列出所有正在运行的进程及其资源使用情况
识别内存和CPU的主要消耗者
进程分类（应用程序、系统、浏览器、开发工具）
实时过程监控

⚡ 性能监控

CPU使用率和核心统计信息
带有交换文件/页面文件详情的内存使用情况
磁盘输入/输出（I/O）统计和空间利用率
网络活动和连接监控
电池状态和电源管理（针对笔记本电脑）
温度监控（Linux/macOS）

🔧 诊断与优化

全面性能诊断
启动程序分析与影响评估
资源瓶颈识别
磁盘清理中的大文件查找
安全状态检查
健康评分并附带可操作的建议

🛠️ 可用工具

工具	描述	使用场景
`initialize_os_connection`	检测并初始化操作系统	初始设置，平台检测
`get_system_overview`	完整系统规格	硬件信息，容量规划
`get_running_processes`	列出活动进程	识别资源占用高的应用程序
`get_performance_summary`	快速健康检查	整体系统状态评估
`get_network_info`	网络状态和使用情况	连接故障排除
`get_disk_usage`	存储容量和输入/输出	磁盘空间管理
`get_battery_info`	电池状态（笔记本电脑）	电源管理，电池健康状况
`get_temperature_info`	系统温度	过热检测（Linux/macOS）
`check_startup_programs`	启动应用程序列表	启动时间优化
`get_user_info`	当前用户和会话	用户管理，会话信息
`find_large_files`	定位占用空间大的文件	磁盘清理，存储优化
`get_installed_software`	列出已安装的应用程序	软件清单
`check_security_status`	安全配置审计	防病毒软件状态，安全评分
`get_system_services`	运行系统服务	服务管理
`get_resource_monitor`	实时资源追踪	实时性能监控
`diagnose_slow_performance`	全面诊断	排查运行缓慢问题
`get_power_settings`	电源管理信息	电池优化，性能模式

💡 SystemMind如何提供帮助

1. 性能故障排除

场景电脑运行缓慢

You: "My computer is running slow, what's wrong?"
AI: [Uses diagnose_slow_performance + get_running_processes]
    "Performance Analysis Complete:
     - Chrome is using 3.5 GB RAM across 15 tabs
     - CPU usage is normal at 18%
     - Memory usage is high at 85%
     
     Root Cause: Memory pressure from browser tabs
     
     Recommendations:
     1. Close unused Chrome tabs (will free ~2 GB)
     2. Restart Chrome to clear memory leaks
     3. Consider adding more RAM if this happens frequently"

2. 资源优化

场景优化系统启动

You: "My laptop takes forever to start, can you help?"
AI: [Uses check_startup_programs + get_performance_summary]
    "Startup Analysis:
     - 45 programs launch at startup
     - Consuming 2.8 GB RAM before you open anything
     - Estimated boot impact: 45-60 seconds
     
     Top startup memory users:
     1. Dropbox: 450 MB
     2. Spotify: 320 MB
     3. Steam: 280 MB
     
     Recommendation: Disable these 3 programs from startup
     Potential improvement: 30-40 second faster boot time"

3. 磁盘空间管理

场景存储空间不足

You: "I'm running out of disk space, what's taking up room?"
AI: [Uses get_disk_usage + find_large_files]
    "Storage Analysis:
     - Total: 1 TB
     - Used: 890 GB (89%) - Almost full!
     - Free: 110 GB
     
     Largest files found:
     1. VirtualBox VM: 85 GB
     2. Old backups: 45 GB
     3. Downloaded videos: 23 GB
     
     Quick wins:
     - Delete old VM snapshots: ~30 GB
     - Remove outdated backups: ~45 GB
     - Potential recovery: 75 GB"

4. 安全审计

场景安全健康检查

You: "Is my computer secure?"
AI: [Uses check_security_status + get_system_overview]
    "Security Assessment:
     
     ✅ Windows Defender: Active and running
     ✅ Firewall: Enabled
     ✅ System Updates: Current (last restart 3 days ago)
     ⚠️  Windows uptime: 45 days - updates pending
     
     Security Score: 85/100
     
     Recommendations:
     1. Restart to apply pending security updates
     2. Enable automatic updates
     
     Overall: Your system has good basic security"

5. 系统健康监测

场景主动系统检查

You: "Give me a health report of my computer"
AI: [Uses get_performance_summary + get_system_overview + get_battery_info]
    "System Health Report:
     
     Overall Status: 🟢 EXCELLENT (92/100)
     
     Hardware:
     - CPU: 8 cores, 18% usage ✅
     - RAM: 16 GB, 42% usage ✅
     - Storage: 550 GB free (55%) ✅
     - Battery: 85% (charging) ✅
     
     Performance:
     - No bottlenecks detected
     - All resources within normal range
     - System uptime: 2 days
     
     Your computer is running optimally!"

6. 温度监测 (Linux/macOS)

场景；情景；设想过热担忧

You: "My laptop feels hot, check the temperatures"
AI: [Uses get_temperature_info + get_resource_monitor]
    "Temperature Analysis:
     
     CPU Temperatures:
     - Core 0: 78°C ⚠️
     - Core 1: 82°C ⚠️
     - Core 2: 79°C ⚠️
     - Core 3: 81°C ⚠️
     
     Status: Running warm under load
     
     Current Activity:
     - CPU usage spiking to 95% during video encoding
     
     Recommendations:
     1. Ensure proper ventilation
     2. Clean dust from vents
     3. Consider laptop cooling pad
     4. Check if thermal paste needs replacement (if old laptop)"

7. 网络诊断

场景连接问题

You: "My internet seems slow, what's using bandwidth?"
AI: [Uses get_network_info + get_resource_monitor + get_running_processes]
    "Network Analysis:
     
     Connection: Wi-Fi @ 866 Mbps
     
     Current Activity (last 5 seconds):
     - Download: 4.2 MB/s
     - Upload: 850 KB/s
     
     Bandwidth consumers:
     1. Steam: Downloading game update
     2. OneDrive: Syncing files
     3. Chrome: Streaming video
     
     Your connection is fine, but multiple apps are competing
     for bandwidth. Pause Steam download for better browsing."

8. 电池优化

场景电池续航能力差

You: "My battery drains too quickly, help me optimize it"
AI: [Uses get_battery_info + get_power_settings + get_running_processes]
    "Battery Optimization Analysis:
     
     Current Status:
     - Battery: 45% (3.2 hours remaining)
     - Power Mode: High Performance ⚠️
     - Screen Brightness: 100% ⚠️
     
     Power-hungry processes:
     - Chrome: 15% CPU (multiple tabs)
     - Spotify: Playing music
     - OneDrive: Syncing
     
     Recommendations:
     1. Switch to 'Balanced' power mode (+45 min)
     2. Reduce brightness to 60% (+30 min)
     3. Close unused Chrome tabs (+20 min)
     4. Pause OneDrive sync while on battery (+15 min)
     
     Potential improvement: 1.5 hours extra battery life"

📋 安装与设置

先决条件

Python 3.8或更高版本
操作系统：Windows 10/11、macOS 10.14+ 或 Linux
所需的Python包： psutil， fastmcp

安装依赖项

pip install -r requirements.txt

运行服务器

python OS_mcp_server.py

服务器已启动并准备好接受MCP连接。

使用Claude Desktop进行配置

添加到您的Claude桌面配置中（claude_desktop_config.json):

克劳德：

{"mcpServers": {
"OS-Mcp": {
    "command": "uv",
    "args": [
        "run",
        "--with",
        "fastmcp",
        "fastmcp",
        "run",
        "path\\to\\proxy.py" 
    ],
    "env": {},
    "transport": "stdio"
}

    }
    
}

Continue.dev（可译为“继续开发平台”或根据具体语境灵活翻译，此处直译为“继续.dev”以保留原名）

name: Sample MCP
version: 0.0.1
schema: v1
mcpServers:
  - name: SystemMind MCP server
    type: streamable-http
    url: http://127.0.0.1:9090/mcp/

🔧 使用示例

如需详细的使用示例，请参阅示例文件夹。

🏗️ 建筑

┌─────────────────────────────────────────┐
│         AI Assistant (Claude)           │
└────────────────┬────────────────────────┘
                 │ MCP Protocol
┌────────────────▼────────────────────────┐
│          SystemMind Server              │
│  ┌─────────────────────────────────┐   │
│  │    Tool Interface Layer         │   │
│  │   (17 diagnostic tools)         │   │
│  └──────────────┬──────────────────┘   │
│  ┌──────────────▼──────────────────┐   │
│  │   OS Detection & Abstraction    │   │
│  └──────────────┬──────────────────┘   │
│  ┌──────────────▼──────────────────┐   │
│  │   Platform-Specific Handlers    │   │
│  │  ┌────────┐ ┌──────┐ ┌───────┐  │   │
│  │  │Windows │ │macOS │ │ Linux │  │   │
│  │  └───┬────┘ └──┬───┘ └───┬───┘  │   │
│  └──────┼─────────┼─────────┼─────┘   │
└─────────┼─────────┼─────────┼─────────┘
          │         │         │
    ┌─────▼─────┐ ┌─▼─────┐ ┌─▼──────┐
    │  Windows  │ │ macOS │ │ Linux  │
    │    OS     │ │  OS   │ │   OS   │
    └───────────┘ └───────┘ └────────┘

🔐 安全考量

SystemMind 需要标准的用户级权限（大多数操作无需 root/admin 权限）
某些操作可能对受限系统目录的访问有限制
无认证层（依赖于MCP传输安全）
不修改系统状态（只读诊断）
异常： clean_temp_files 是唯一一个修改文件的工具（默认情况下禁用）
建议：在受信任的环境中使用或为远程访问添加认证

🎨 输出格式化

SystemMind使用富含表情符号的、用户友好的格式：

🟢 绿色指标表示健康状态良好
🟡 黄色表示警告
🔴 红色表示严重问题
✅ 对勾表示状态良好
⚠️ 需注意项目的警告标志
📊 在适用的情况下使用图表和视觉表示

🚧 路线图/发展蓝图

计划中的功能

\[ \] 高级网络诊断（端口扫描、连接测试）
\[ \] 提供一键操作的自动化清理建议
\[ \] 历史业绩追踪
\[ \] 导出诊断报告（PDF/JSON）
\[ \] 网页用户界面仪表板

平台特定增强功能

\[ \] Windows：注册表健康检查
\[ \] macOS：Spotlight 索引状态
\[ \] Linux：systemd 服务管理

🤝 贡献

欢迎投稿！改进方向包括：

针对特定平台的额外诊断工具
增强的指标可视化
性能优化
扩展硬件监控
文档改进
测试覆盖率扩展

如何贡献（或：如何投稿/如何参与）

为仓库创建分支（或“克隆仓库”）
创建一个特性分支（git checkout -b feature/amazing-feature)
提交您的更改（git commit -m 'Add amazing feature'）
推送至分支（git push origin feature/amazing-feature）
提交一个拉取请求

📊 对比：SystemMind 与 ContainMind

特性	SystemMind	ContainMind
范围	操作系统	容器
目标	系统管理员，终端用户	DevOps工程师，开发人员
平台	Windows、macOS、Linux	Docker、Podman
用例	系统健康、性能	容器编排
复杂性	用户友好，易于访问	技术性强，以开发者为中心
集成	共同协作实现全栈监控	共同协作实现全栈监控

携手共进，更胜一筹 使用SystemMind监控您的主机系统，并使用ContainMind监控运行在其上的容器！

🐛 故障排除

常见问题

工具返回：“请先运行‘initialize_os_connection’”

解决方案：务必致电 initialize_os_connection() 在使用其他工具之前

“未从客户端工具执行中收到结果”

原因：工具超时或权限错误
解决方案：检查权限，尝试使用较小的作用域（例如，限制为 find_large_files）

温度监测功能不可用（Windows）

这是预料之中的——Windows并未通过标准API公开温度传感器
使用像HWMonitor这样的第三方工具进行Windows系统的温度监控

扫描文件时出现权限错误

系统目录的正常情况 - 工具将跳过无法访问的文件
检查输出中的“权限错误”计数

📄 许可证

此项目采用MIT许可证授权——详情请参阅LICENSE文件。

🙏 致谢

构建于：

FastMCP - MCP服务器框架
psutil - 跨平台系统实用工具
Anthropic Claude（注：此处“Anthropic”可能指的是开发Claude模型的公司或研究机构，但具体翻译可能因上下文而异，此处保留原英文以体现可能的专有名词性质） - AI助手集成

特别感谢开源社区提供的优秀工具和库。

📞 支持

问题：
讨论：
文档：维基

🌟 明星历史

如果你觉得SystemMind很有帮助，请在GitHub上给它点个星⭐！

______________________________________________________________________

SystemMind（可译为“系统思维”或根据具体语境译为其他更贴切的表述，但“SystemMind”本身作为一个专有名词或品牌名时，通常直接保留不译） - 让系统管理变得对话式、智能化且人人皆可使用。 🚀

💼 神经思维套件（或“心智套件”，根据具体语境可灵活翻译）

SystemMind是……的一部分 Mind Suite（思维套件/智慧组合） - 一系列智能管理工具的集合：

🐋（海豚） ContainMind（可译为“心智管控”或根据具体语境调整为更贴切的表达，但直接翻译保持原样为“心智包含”可能不够准确，需结合上下文理解） - 通用容器管理
🖥️ SystemMind（可译为“系统思维”或根据具体语境译为更贴切的名称，此处保留原英文以体现其专业性） - 操作系统智能（本项目）

*从容器到操作系统——事无巨细，皆需留意。* 🧠 表示“大脑”或“思考”。

System Mind

快速接入

详细介绍