@wangguanxiao/feiniunas-mcp

飞牛 fnOS NAS 管理 MCP 服务，通过小智 AI 对话即可管理 NAS。

功能

• get_nas_status — 获取 NAS 系统状态（主机名、运行时间、CPU 负载、内存、磁盘概况）

• list_docker_containers — 列出所有 Docker 容器及运行状态

• get_disk_info — 获取磁盘/存储详细信息

• control_docker_container — 启动/停止/重启/删除 Docker 容器

安装

npm install -g @wangguanxiao/feiniunas-mcp

使用

在 xiaozhi.config.json 中配置

{
  "mcpServers": {
    "feiniunas": {
      "command": "npx",
      "args": ["-y", "@wangguanxiao/feiniunas-mcp"]
    }
  }
}

或本地开发模式：

{
  "mcpServers": {
    "feiniunas": {
      "command": "node",
      "args": ["/path/to/feiniunas-mcp/run.js"]
    }
  }
}

示例对话

• "NAS 现在什么状态？" → 调用 get_nas_status

• "列出所有 Docker 容器" → 调用 list_docker_containers

• "磁盘还剩多少空间？" → 调用 get_disk_info

• "帮我重启 xxx 容器" → 调用 control_docker_container

开发

# 安装依赖
npm install

# 构建
npm run build

# 本地运行
node run.js

# 类型检查
npm run type-check

要求

• Node.js >= 18

• 运行在飞牛 NAS 或 Linux 环境上（依赖 hostname、uptime、free、df、docker 等系统命令）

• Docker 命令需要当前用户有执行权限

安全说明

• control_docker_container 对容器名做了字符校验，只允许字母数字和 _-.:

• 不支持 exec、run 等可能在容器内执行任意命令的操作

• 建议以非 root 用户运行，配合 Docker 用户组权限