🛡️ 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爱好者来说。*