QNAP Container Station

БесплатноНе проверен

Enables managing Docker containers and Compose apps on a QNAP NAS via the Container Station API, including starting, stopping, restarting, and inspecting contai

автор: baekhoej

GitHub Embed

Описание

Enables managing Docker containers and Compose apps on a QNAP NAS via the Container Station API, including starting, stopping, restarting, and inspecting containers and applications.

README

MCP server for managing containers on a QNAP NAS via the Container Station API.

Disclaimers

This is a personal project, built for use on my own NAS. It is not affiliated with, endorsed by, or in any way connected to QNAP Systems, Inc. QNAP and Container Station are trademarks of their respective owners.

This project is shared as-is. I make no claims about its suitability for any purpose other than my own use. Use it at your own risk.

Setup

npm install
cp .env.example .env
# Edit .env with your QNAP credentials
npm run build

Configuration

Create a .env file (never commit this):

QNAP_URL=https://your-qnap.local
QNAP_USERNAME=container-mcp
QNAP_PASSWORD=your-password
QNAP_VERIFY_SSL=false

QNAP_VERIFY_SSL=false is needed for self-signed certificates (default on most QNAP devices).

Claude Code

Add to .mcp.json in your project root:

{
  "mcpServers": {
    "qnap-container-station": {
      "command": "node",
      "args": ["/path/to/qnap-containerstation-mcp/dist/index.js"],
      "env": {
        "QNAP_URL": "https://your-qnap.local",
        "QNAP_USERNAME": "container-mcp",
        "QNAP_PASSWORD": "your-password",
        "QNAP_VERIFY_SSL": "false"
      }
    }
  }
}

Claude Desktop

Add to ~/.config/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "qnap-container-station": {
      "command": "node",
      "args": ["/path/to/qnap-containerstation-mcp/dist/index.js"],
      "env": {
        "QNAP_URL": "https://your-qnap.local",
        "QNAP_USERNAME": "container-mcp",
        "QNAP_PASSWORD": "your-password",
        "QNAP_VERIFY_SSL": "false"
      }
    }
  }
}

Available Tools

Tool	Description
`list_containers`	List all containers with state, image, type
`get_container`	Get details for a specific container
`get_container_logs`	Fetch logs for a Docker container
`start_container`	Start a container
`stop_container`	Stop a container
`restart_container`	Restart a container
`list_apps`	List Docker Compose applications
`start_app`	Start a Compose app
`stop_app`	Stop a Compose app
`restart_app`	Restart a Compose app
`get_system_resource`	Get CPU and memory usage
`list_networks`	List Docker networks
`get_logs`	Query Container Station system logs

Note: Confirmed working on Container Station 3.x: list_containers, list_apps, start_container, stop_container, restart_container. Other endpoints may return 404 depending on your Container Station version.

Tests

# Unit tests
npm test

# Live API tests (requires .env or env vars)
npm run test:live

# Override the test container (must be safe to stop/start)
QNAP_TEST_CONTAINER_ID=<container-id> npm run test:live

from github.com/baekhoej/qnap-containerstation-mcp

Установить QNAP Container Station в Claude Desktop, Claude Code, Cursor

Рекомендуется · одна команда, все IDE

unyly install qnap-container-station-mcp

Ставит в Claude Desktop, Claude Code, Cursor и VS Code — сам разбирается с npx, uvx и сборкой из исходников.

Впервые? Поставь CLI: curl -fsSL https://unyly.org/install | sh

Или настроить вручную

Выполни в терминале:

claude mcp add qnap-container-station-mcp -- npx -y @baekhoej/qnap-containerstation-mcp

FAQ