QNAP Container Station MCP
Provides tools for managing Docker containers and Compose applications on a QNAP NAS, including starting, stopping, restarting containers and apps, listing containers and networks, and fetching logs.
Integrates with QNAP Container Station to manage Docker containers and Compose applications on a QNAP NAS, offering tools for container lifecycle management, system resource monitoring, and log retrieval.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@QNAP Container Station MCPlist all containers"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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.
Setup
npm install
cp .env.example .env
# Edit .env with your QNAP credentials
npm run buildConfiguration
Create a .env file (never commit this):
QNAP_URL=https://your-qnap.local
QNAP_USERNAME=container-mcp
QNAP_PASSWORD=your-password
QNAP_VERIFY_SSL=falseQNAP_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 all containers with state, image, type |
| Get details for a specific container |
| Fetch logs for a Docker container |
| Start a container |
| Stop a container |
| Restart a container |
| List Docker Compose applications |
| Start a Compose app |
| Stop a Compose app |
| Restart a Compose app |
| Get CPU and memory usage |
| List Docker networks |
| 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:liveThis server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
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