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：CPU、メモリ、および toon テーブルを使用したディスクとボリュームの情報を含む、包括的なMarkdown システムレポートを生成します。人間にも AI による分析にも最適です。
• qnap-dir：変更日順に自動で並べ替え、ディレクトリの内容を見やすい表形式で一覧表示します。
  • path：一覧表示するパス（例：/Public）。
• qnap-file-info：特定のファイルの詳細情報を取得します。
  • path：ディレクトリのパス。
  • filename：ファイル名。

リソース

このサーバーは、監視用の構造化 JSON データを提供するため、QNAP のシステムコンポーネントを MCP リソースとして公開します。

• ディスク：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ファイルを参照してください。