Qnap

io.github.marcelo-ochoa由 GitHub 账号 marcelo-ochoa 发布v1.0.8更新于 Oct 24, 2026

MCP server for QNAP NAS API

概览

AI 生成的概览

面向 QNAP NAS 的 MCP 服务器,让助手连接 NAS、监控系统健康与存储、浏览文件并生成 Markdown 报告。

可以做什么
  • 使用主机地址和管理员凭据连接 QNAP NAS 并获取会话 ID
  • 生成包含 CPU、内存、磁盘和卷的 Markdown 系统报告
  • 以按修改时间排序的表格形式列出目录内容
  • 查询指定文件的详细信息
  • 以结构化 JSON 资源读取磁盘和卷数据,用于健康与容量监控
适用场景
适合让助手查看 QNAP NAS 的健康状态、存储占用和文件列表,或生成可读的系统报告,而无需自己登录 NAS 网页界面。
运行要求
以本地 stdio 进程运行,通常通过 npx 或 Docker 镜像启动。需要能访问 NAS 地址的网络,以及管理员用户名和密码,可通过连接工具或 QNAP_USER、QNAP_PASSWORD 环境变量提供;主机地址可作为启动参数传入以自动连接。
安装前请注意
该服务器需要 QNAP 管理员凭据,并以 QNAP_USER 和 QNAP_PASSWORD 形式保存在客户端配置中;建议使用专用账号并保护配置文件。凭据和 NAS 数据会发送到你配置的 NAS 地址,请只指向可信主机。文档列出的文件工具为只读,但管理员账号本身权限很大。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Qnap,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

QNAP MCP Server

An MCP server implementation for QNAP NAS devices, providing tools to monitor system status, manage files, and generate reports.

Tools

  • qnap-connect: Connect to a QNAP NAS and obtain a session ID.
    • host: The QNAP NAS URL (e.g., http://10.1.1.241:8080).
    • username: Your admin username.
    • password: Your admin password.
  • qnap-report: Generate a comprehensive Markdown system report including CPU, memory, powered by toon tables for disks and volumes. Perfect for both human reading and AI analysis.
  • qnap-dir: List the contents of a directory in a professional tabular format, automatically sorted by modification date.
    • path: The path to list (e.g., /Public).
  • qnap-file-info: Get detailed information about a specific file.
    • path: The directory path.
    • filename: The name of the file.

Resources

The server exposes QNAP system components as MCP Resources, providing structured JSON data for monitoring:

  • Disks: qnap://[host]:[port]/disk/[disk-id]
    • Real-time disk health, model, serial, and temperature.
  • Volumes: qnap://[host]:[port]/volume/[volume-id]
    • Detailed storage usage, capacity, and volume names.

These resources allow AI models to monitor NAS health and storage levels without manually calling reporting tools.

Configuration

Environment Variables

The server can use environment variables and startup arguments for automatic connection:

  • QNAP_USER: QNAP admin username.
  • QNAP_PASSWORD: QNAP admin password.

Startup Arguments

  1. host: (Optional) URL of the QNAP NAS (e.g., http://10.1.1.241:8080).

If the host and environment variables are provided, the server will attempt to connect automatically at startup.

Usage with Claude Desktop

Add the following to your claude_desktop_config.json:

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

using docker image

json
{  "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"      ]    }  }}

Development

bash
cd src/qnapnpm installnpm run build

Demos

See Demos for usage examples with Claude Desktop, Gemini CLI, and Antigravity Code Editor.

Docker

Building the container:

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

Running the container:

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

Change Log

See Change Log for the history of changes.

📜 License

This project is licensed under the Apache License, Version 2.0 for new contributions, with existing code under MIT - see the LICENSE file for details.

来源:src/qnap/README.md,提交 bd2ce8f

工具

0
SourceWeft 尚未在沙箱中启动过该软件包,因此其工具未知。

版本历史

1
  1. v1.0.8最新Sep 16, 2026

评分

已满足适用检查项的 40%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。