qnap

QNAP MCP 服务

面向 QNAP NAS 设备的 MCP 服务实现，提供用于监控系统状态、管理文件和生成报告的工具。

工具

• qnap-connect：连接到 QNAP NAS 并获取会话 ID。
  • host：QNAP NAS URL（例如，http://10.1.1.241:8080）。
  • username：管理员用户名。
  • password：管理员密码。
• qnap-report：生成全面的 Markdown 系统报告，包含 CPU、内存，以及由 toon 表格呈现的磁盘和卷信息。既适合人类阅读，也适合 AI 分析。
• qnap-dir：以专业表格格式列出目录内容，并按修改日期自动排序。
  • path：要列出的路径（例如，/Public）。
• qnap-file-info：获取特定文件的详细信息。
  • path：目录路径。
  • filename：文件名。

资源

该服务将 QNAP 系统组件作为 MCP 资源公开，提供结构化的 JSON 数据以供监控：

• 磁盘：qnap://[host]:[port]/disk/[disk-id]
  • 实时磁盘健康状况、型号、序列号和温度。
• 卷：qnap://[host]:[port]/volume/[volume-id]
  • 详细的存储使用情况、容量和卷名称。

这些资源让 AI 模型无需手动调用报告工具，即可监控 NAS 健康状况和存储空间使用情况。

配置

环境变量

该服务可以使用环境变量和启动参数来自动连接：

• QNAP_USER：QNAP 管理员用户名。
• QNAP_PASSWORD：QNAP 管理员密码。

启动参数

1. host：（可选）QNAP NAS 的 URL（例如，http://10.1.1.241:8080）。

如果提供了主机地址和环境变量，该服务将在启动时尝试自动连接。

与 Claude Desktop 搭配使用

将以下内容添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "qnap": {
      "command": "npx",
      "args": [
        "-y",
        "@marcelo-ochoa/server-qnap",
        "http://10.1.1.241:8080"
      ],
      "env": {
        "QNAP_USER": "admin",
        "QNAP_PASSWORD": "password"
      }
    }
  }
}

使用 Docker 镜像

{
  "mcpServers": {
    "qnap": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "QNAP_USER=admin",
        "-e",
        "QNAP_PASSWORD=password",
        "mochoa/mcp-qnap",
        "http://10.1.1.241:8080"
      ]
    }
  }
}

开发

cd src/qnap
npm install
npm run build

演示

查看 演示，了解在 Claude Desktop、Gemini CLI 和 Antigravity Code Editor 中的使用示例。

Docker

构建容器：

docker build -t mochoa/mcp-qnap -f src/qnap/Dockerfile .

运行容器：

docker run -i --rm -e QNAP_USER=admin -e QNAP_PASSWORD=password mochoa/mcp-qnap http://10.1.1.241:8080

更新日志

查看 更新日志，了解变更历史。

📜 许可证

对于新的贡献，本项目采用 Apache License, Version 2.0 许可；现有代码采用 MIT 许可。详情请参阅 LICENSE 文件。