DivLens MCP 服务说明文档
1. 服务概述一句话简介为AI代理提供实时系统智能工具支持CPU、RAM、存储、网络、硬件诊断和开发者栈查询服务名称DivLens MCP版本号最新版本开发者/提供方Lohithry协议类型MCP (Model Context Protocol)许可证Apache License, Version 2.0编程语言Rust2. 核心功能DivLens MCP 是一个高性能的 MCP 服务器为 Claude、Cursor、Windsurf 等 AI 助手提供实时、结构化的硬件传感器、存储指标、网络诊断、进程树、开发者运行时、系统日志等访问能力。提供 17 个诊断工具分类工具名称功能描述⚡ 性能get_live_metricsCPU %、RAM、swap、阻塞进程、运行时间⚡ 性能get_process_list按 CPU/RAM 排序的顶级进程及 PID 存储get_storage_health每个挂载点的可用/已用/总空间 存储scan_storage_inventory完整的文件类型清单及大小 存储get_file_type_summary按扩展名统计文件数量和大小 存储get_specific_file_type匹配特定扩展名的所有文件 存储get_advanced_storage_stats前50个最大文件 陈旧数据分析 存储get_storage_diagnosticsIOPS、读/写延迟、SMART 状态️ 硬件get_hardware_diagnosticsCPU/GPU 规格、电池 %、温度、SMART 网络get_network_diagnostics吞吐量、活动连接、信号强度 网络get_network_configIP、DNS、每个适配器的接口配置 身份get_system_dnaOS、主机名、运行时间、机器指纹️ 开发栈get_dev_stackNode、Python、Rust、Go、Java 运行时 包️ 开发栈get_drivers内核模块和设备驱动程序 实用工具scan_directory递归目录列表及大小 内存recall_memory对过去 AI 诊断的语义搜索 日志get_system_logs按模式聚类的最近 OS/内核错误3. 使用场景DivLens MCP 让 AI 助手能够实时访问您的机器信息适用于以下场景性能问题诊断为什么我的 Mac 变慢 → Claude 调用 get_live_metrics() → 即时获得答案硬件健康检查我的 SSD 健康吗 → Claude 调用 get_hardware_diagnostics() → 返回 SMART 数据磁盘空间分析什么占用了磁盘空间 → Claude 调用 get_advanced_storage_stats() → 列出最大文件网络问题排查检查网络吞吐量、活动连接和信号强度开发者环境检查查看已安装的运行时环境和包管理器系统监控实时监控系统性能指标和资源使用情况4. 接入方式4.1 服务端点该MCP服务通过 stdio 传输协议运行支持本地部署。无需云服务、无需 API 密钥、无需配置。4.2 认证与权限该服务运行在本地环境继承当前用户的系统权限无需额外的认证机制。所有数据都保留在您的机器上不会发送到任何地方。4.3 数据格式服务使用 MCP 协议标准的数据格式进行通信每个 MCP 消息都是通过 stdio 传输的换行分隔的 JSON-RPC 2.0 对象。4.4 服务器配置Claude Desktop 配置配置文件位置macOS:~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:%APPDATA%\Claude\claude_desktop_config.json{ mcpServers: { divlens: { command: /usr/local/bin/divlens-core, args: [--mcp] } } }Cursor 配置配置文件位置~/.cursor/mcp.json{ mcpServers: { divlens: { command: /usr/local/bin/divlens-core, args: [--mcp] } } }Windsurf 配置配置文件位置~/.codeium/windsurf/mcp_config.json{ mcpServers: { divlens: { command: /usr/local/bin/divlens-core, args: [--mcp] } } }5. 接口定义DivLens MCP 提供 17 个诊断工具接口分为以下几大类性能监控实时 CPU、RAM、进程监控存储分析磁盘空间、文件类型统计、存储诊断硬件诊断CPU/GPU 规格、电池状态、温度监控网络诊断网络配置、吞吐量、连接状态系统身份OS 信息、主机名、机器指纹开发者栈运行时环境、包管理器、驱动程序实用工具目录扫描、语义记忆、系统日志6. 快速开始6.1 环境要求操作系统macOS、Linux、Windows从源码构建Rust 1.82可选功能语义记忆功能需要启用 vector-memory 特性6.2 安装方式方式一一键安装推荐macOS Linuxcurl -fsSL https://raw.githubusercontent.com/Lohithry/divlens-mcp/main/install.sh | bashWindows (PowerShell - 无需管理员权限)irm https://raw.githubusercontent.com/Lohithry/divlens-mcp/main/install.ps1 | iex安装程序会自动✅ 检测您的操作系统和芯片Apple Silicon / Intel / Linux / Windows✅ 从 GitHub Releases 下载正确的预构建二进制文件✅ 验证 SHA-256 校验和✅ 安装到 PATH无需管理员权限✅ 自动配置 Claude Desktop、Cursor、Windsurf 和 Antigravity✅ 在完成前测试服务器是否正常工作方式二从源码构建高级用户git clone https://github.com/Lohithry/divlens-mcp.git cd divlens-mcp/apps/core cargo build --release ./target/release/divlens-core --mcp启用语义记忆功能cargo build --release --features vector-memory6.3 验证服务器测试 MCP 协议无需客户端# 初始化握手 echo {jsonrpc:2.0,id:1,method:initialize,params:{protocolVersion:2024-11-05,clientInfo:{name:test,version:0.1}}} \ | divlens-core --mcp # 直接调用工具 echo {jsonrpc:2.0,id:2,method:tools/call,params:{name:get_live_metrics,arguments:{}}} \ | divlens-core --mcp7. 注意事项隐私保护所有数据都保留在您的机器上不会发送到任何地方权限要求该服务继承当前用户的系统权限请确保在受信任的环境中使用零云依赖无需云服务、无需 API 密钥、无需配置AI 逻辑DivLens 从不运行 LLM 推理 - 它只收集和返回原始系统数据语义记忆启用 vector-memory 功能后会创建本地 LanceDB 向量存储使用 fastembed 嵌入和语义回忆过去的诊断平台兼容性支持 macOS、Linux 和 Windows自动检测操作系统和芯片架构工作原理DivLens MCP 采用分层架构设计传输层JSON-RPC 2.0 over stdioMCP 层处理 JSON-RPC 协议工具层17 个诊断工具实现Rust OS数据层SQLite 缓存 原生 APIIOKit/WMI相关资源GitHub 仓库GitHub - Lohithry/divlens-mcp · GitHub部署文档DEPLOYMENT.md许可证Apache License, Version 2.0