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 分

    請在儲存庫或註冊中心條目中宣告授權條款。