Generic MCP server for UGREEN NAS (UGOS) over SSH — 39 tools with dry-run safety.
Connect Runs on your machine
claude mcp add ugnas-mcp -e UGNAS_MCP_CONFIG=<UGNAS_MCP_CONFIG> -e UGNAS_HOST=<UGNAS_HOST> -e UGNAS_USER=<UGNAS_USER> -e UGNAS_KEY_PATH=<UGNAS_KEY_PATH> -e UGNAS_PASSWORD=<UGNAS_PASSWORD> -e UGNAS_PORT=<UGNAS_PORT> -e UGNAS_DEFAULT_SHARE=<UGNAS_DEFAULT_SHARE> -e UGNAS_HOST_KEY_SHA256=<UGNAS_HOST_KEY_SHA256> -- npx -y [email protected]{
"mcpServers": {
"ugnas-mcp": {
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"UGNAS_MCP_CONFIG": "<UGNAS_MCP_CONFIG>",
"UGNAS_HOST": "<UGNAS_HOST>",
"UGNAS_USER": "<UGNAS_USER>",
"UGNAS_KEY_PATH": "<UGNAS_KEY_PATH>",
"UGNAS_PASSWORD": "<UGNAS_PASSWORD>",
"UGNAS_PORT": "<UGNAS_PORT>",
"UGNAS_DEFAULT_SHARE": "<UGNAS_DEFAULT_SHARE>",
"UGNAS_HOST_KEY_SHA256": "<UGNAS_HOST_KEY_SHA256>"
}
}
}
}{
"mcpServers": {
"ugnas-mcp": {
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"UGNAS_MCP_CONFIG": "<UGNAS_MCP_CONFIG>",
"UGNAS_HOST": "<UGNAS_HOST>",
"UGNAS_USER": "<UGNAS_USER>",
"UGNAS_KEY_PATH": "<UGNAS_KEY_PATH>",
"UGNAS_PASSWORD": "<UGNAS_PASSWORD>",
"UGNAS_PORT": "<UGNAS_PORT>",
"UGNAS_DEFAULT_SHARE": "<UGNAS_DEFAULT_SHARE>",
"UGNAS_HOST_KEY_SHA256": "<UGNAS_HOST_KEY_SHA256>"
}
}
}
}{
"servers": {
"ugnas-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"UGNAS_MCP_CONFIG": "<UGNAS_MCP_CONFIG>",
"UGNAS_HOST": "<UGNAS_HOST>",
"UGNAS_USER": "<UGNAS_USER>",
"UGNAS_KEY_PATH": "<UGNAS_KEY_PATH>",
"UGNAS_PASSWORD": "<UGNAS_PASSWORD>",
"UGNAS_PORT": "<UGNAS_PORT>",
"UGNAS_DEFAULT_SHARE": "<UGNAS_DEFAULT_SHARE>",
"UGNAS_HOST_KEY_SHA256": "<UGNAS_HOST_KEY_SHA256>"
}
}
}
}Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.
Tools
This server runs locally, so its tools are listed by your MCP client once it starts.
Environment variables
| Name | Description |
|---|---|
UGNAS_MCP_CONFIGOptional | Path to the config JSON (default: ~/.ugnas-mcp/config.json). See the README for the schema. |
UGNAS_HOSTOptional | NAS host, e.g. 192.168.1.50. Overrides the config file. |
UGNAS_USEROptional | SSH username. Overrides the config file. |
UGNAS_KEY_PATHOptional, secret | Path to the SSH private key (alternative to UGNAS_PASSWORD). |
UGNAS_PASSWORDOptional, secret | SSH password (alternative to UGNAS_KEY_PATH). |
UGNAS_PORTOptional | SSH port. Overrides the config file. |
UGNAS_DEFAULT_SHAREOptional | Base directory for relative tool paths (default /volume1). |
UGNAS_HOST_KEY_SHA256Optional | Pinned SSH host key fingerprint (SHA256:...). |
Details
| Package | [email protected] (NPM, stdio) |
| First published | 17 Oct 2026 |
| Last updated | 17 Oct 2026 |
| Registry name | io.github.Omodaka9375/ugnas-mcp |
More other servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.