AI导哈

AI家庭实验室控制服务

MCP-NAS是一款通过AI助手控制家庭实验室的服务，提供实时监控、Docker管理和安全智能功能，适用于Linux/NAS系统。

  • by cneuen
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 cneuen/mcp-nas

使用说明

🛡️ MCP-NAS：人工智能家庭实验室控制

通过配备Maximalist Security的AI助手控制您的家庭实验室

这 mcp-nas agent是一个实验性的模型上下文协议（MCP）服务器。它使任何兼容的LLM助手都可以通过SSH与Linux/NAS系统进行本地交互，以实现实时监控、Docker管理和安全智能。

✨ 哲学与“零信任”安全

  • 无代理：标准SSH通信。
  • 最小权限：受限 mcp-agent 特定用户 sudo 白名单。
  • 强认证：仅限非对称密钥（ED25519）。
  • 强化密钥使用：安装脚本会自动锁定SSH密钥(no-pty, no-port-forwarding)以防止交互式shell访问或隧道。
  • 审计日志：自部署的SSH Wrapper拦截AI代理执行的每个命令并将其记录到NAS syslog中(/var/log/syslog 或 auth.log).
  • 数据隔离：没有硬编码凭据。

⚠️ 重要安全警告（请阅读）

  • 特权代理人：虽然受到限制 mcp-agent 控制Docker。例如，通过 docker compose，攻击者可以挂载主机文件系统。 将运行MCP客户端的机器视为高权限环境。 如果您的本地工作站受到威胁，您的NAS将面临风险。
  • 不直接接触互联网: 从不 将您的NAS SSH端口（22）直接暴露到互联网。始终使用本地网络或安全的VPN（Wireguard/Tailscale）。
  • 数据隐私：使用此MCP服务器意味着您的系统日志（例如。， /var/log, journalctl)被发送到Anthropic的云端进行人工智能分析。确保日志中没有以明文形式写入高度敏感的密码或API密钥。

🚀 模块化功能

代理人被组织成 核心 模块（通用）和 整合 模块（特定于解决方案）。

🐧 Linux核心功能

可在任何标准Linux NAS（Debian、Ubuntu等）上原生运行

  • 📊 监控：CPU、RAM、正常运行时间、温度（CPU/HDD）和实时网络流量。
  • 🗄️ 存储：通用RAID状态(mdstat)、文件系统使用情况和SMART磁盘健康状况。
  • 📜 日志：远程访问 /var/log, journalctl，以及SSH登录审核。

🧩 集成和解决方案

检测到服务时激活的智能模块。

  • 🐶 OpenMediaVault：与OMV RPC深度集成，用于堆栈管理和更新。
  • 🐳 Docker和Compose：本地容器和独立组合堆栈的管理。
  • 🚦 交通：通过标签自动发现反向代理路由和后端运行状况。
  • 🛡️ 安全：CrowdSec禁令监控、VPN状态（Wireguard/Tailscale）和SSH审计。

🛠️ 安装和配置

1.NAS准备

直接从存储库在NAS上安全运行安装脚本（以root身份）：

# Download and execute the setup script
curl -fsSL https://raw.githubusercontent.com/cneuen/mcp-nas/main/setup-mcp-nas.sh -o setup-mcp-nas.sh
chmod +x setup-mcp-nas.sh
sudo ./setup-mcp-nas.sh "mcp-agent" "YOUR_SSH_PUBLIC_KEY"

2.MCP客户端配置

修改您的MCP客户端配置（例如。 claude_desktop_config.json、克莱恩等）：

"mcpServers": {
  "mcp-nas": {
  "command": "npx",
  "args": ["-y", "@cneuen/mcp-nas@latest"],
  "env": {
    "NAS_HOST": "192.168.1.X",
    "NAS_USER": "mcp-agent",
    "NAS_KEY_PATH": "C:/Users/USER/.ssh/id_ed25519"
  }
}

🧭 如何与NAS交互？

  • “给我一份NAS的健康报告。”
  • “Traefik上的活动路线是什么？”
  • “CrowdSec最近是否禁止了任何IP？”
  • “更新'emby'堆栈。”

制作❤️ 对于Homelab爱好者来说。

相关 MCP