Skip to main content
Glama
baekhoej

QNAP Container Station MCP

by baekhoej

QNAP Container Station MCP

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.

Related MCP server: Homelab MCP Server

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
A
license - permissive license
-
quality - not tested
C
maintenance

Maintenance

Maintainers
Response time
1dRelease cycle
2Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    -
    quality
    D
    maintenance
    Enables AI assistants to manage Docker containers, deploy stacks, and monitor services across multiple Docker hosts from one centralized location. Supports container lifecycle management, Docker Compose operations, and infrastructure orchestration through natural language commands.
    6
    MIT
  • A
    license
    A
    quality
    A
    maintenance
    Manage Docker infrastructure across multiple homelab hosts including Unraid, Proxmox, and bare metal servers. Enables container lifecycle management, log retrieval, resource monitoring, and Docker operations across your entire homelab from a single interface.
    1
    30
    2
    MIT
  • A
    license
    B
    quality
    C
    maintenance
    Enables managing Docker containers and Docker Compose projects on Synology NAS via SSH, with auto-privilege escalation and full compatibility with Synology Container Manager.
    7
    20
    1
    MIT
  • F
    license
    -
    quality
    D
    maintenance
    Enables managing Docker containers and Portainer resources through natural language, supporting stack deployment, container operations, and environment monitoring.

View all related MCP servers

Related MCP Connectors

  • Search, document and execute authenticated API calls across 500+ apps via one MCP server

  • Control Unreal Engine to browse assets, import content, and manage levels and sequences. Automate…

  • Create and manage CodeQR short links, QR codes, and analytics from any MCP client.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/baekhoej/qnap-containerstation-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server