homelab-mcp
Rank #43,215io.github.Michael-WhiteCapData/WhiteCapData-Dev
Operate a k3s / Kubernetes cluster from your AI agent — safe-by-default MCP server.
homelab-mcp is a Model Context Protocol (MCP) server published by michael-whitecapdata. It ranks #43,215 of 115,460 servers tracked on MCP Toplist, and its repository has 2 GitHub stars. homelab-mcp is listed across 3 registries — Official MCP, Glama and PulseMCP, with 1 tracked version. It was first listed on Jun 21, 2026 and most recently updated on Jun 21, 2026.
Ranks ahead of 72,245 of 115,460 servers on MCP Toplist.
Use homelab-mcp
No credentials or required configuration declared — add it to your MCP client and go.
claude mcp add whitecapdata-dev -e "HOMELAB_MCP_CONTEXT=<your HOMELAB_MCP_CONTEXT>" -e "HOMELAB_MCP_READONLY=<your HOMELAB_MCP_READONLY>" -e "HOMELAB_MCP_MUTABLE_NAMESPACES=<your HOMELAB_MCP_MUTABLE_NAMESPACES>" -e "HOMELAB_MCP_MAX_REPLICAS=<your HOMELAB_MCP_MAX_REPLICAS>" -- uvx whitecapdata-devReplace each placeholder with your own value before saving.
[mcp_servers.whitecapdata-dev]
command = "uvx"
args = ["whitecapdata-dev"]
[mcp_servers.whitecapdata-dev.env]
HOMELAB_MCP_CONTEXT = "<your HOMELAB_MCP_CONTEXT>"
HOMELAB_MCP_READONLY = "<your HOMELAB_MCP_READONLY>"
HOMELAB_MCP_MUTABLE_NAMESPACES = "<your HOMELAB_MCP_MUTABLE_NAMESPACES>"
HOMELAB_MCP_MAX_REPLICAS = "<your HOMELAB_MCP_MAX_REPLICAS>"Add to ~/.codex/config.toml. Replace each placeholder with your own value before saving.
{
"mcpServers": {
"whitecapdata-dev": {
"command": "uvx",
"args": [
"whitecapdata-dev"
],
"env": {
"HOMELAB_MCP_CONTEXT": "<your HOMELAB_MCP_CONTEXT>",
"HOMELAB_MCP_READONLY": "<your HOMELAB_MCP_READONLY>",
"HOMELAB_MCP_MUTABLE_NAMESPACES": "<your HOMELAB_MCP_MUTABLE_NAMESPACES>",
"HOMELAB_MCP_MAX_REPLICAS": "<your HOMELAB_MCP_MAX_REPLICAS>"
}
}
}
}Add to claude_desktop_config.json (Settings → Developer → Edit Config). Replace each placeholder with your own value before saving.
{
"mcpServers": {
"whitecapdata-dev": {
"command": "uvx",
"args": [
"whitecapdata-dev"
],
"env": {
"HOMELAB_MCP_CONTEXT": "<your HOMELAB_MCP_CONTEXT>",
"HOMELAB_MCP_READONLY": "<your HOMELAB_MCP_READONLY>",
"HOMELAB_MCP_MUTABLE_NAMESPACES": "<your HOMELAB_MCP_MUTABLE_NAMESPACES>",
"HOMELAB_MCP_MAX_REPLICAS": "<your HOMELAB_MCP_MAX_REPLICAS>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per project). Replace each placeholder with your own value before saving.
{
"servers": {
"whitecapdata-dev": {
"type": "stdio",
"command": "uvx",
"args": [
"whitecapdata-dev"
],
"env": {
"HOMELAB_MCP_CONTEXT": "<your HOMELAB_MCP_CONTEXT>",
"HOMELAB_MCP_READONLY": "<your HOMELAB_MCP_READONLY>",
"HOMELAB_MCP_MUTABLE_NAMESPACES": "<your HOMELAB_MCP_MUTABLE_NAMESPACES>",
"HOMELAB_MCP_MAX_REPLICAS": "<your HOMELAB_MCP_MAX_REPLICAS>"
}
}
}
}Save as .vscode/mcp.json in your workspace. Replace each placeholder with your own value before saving.
{
"mcpServers": {
"whitecapdata-dev": {
"command": "uvx",
"args": [
"whitecapdata-dev"
],
"env": {
"HOMELAB_MCP_CONTEXT": "<your HOMELAB_MCP_CONTEXT>",
"HOMELAB_MCP_READONLY": "<your HOMELAB_MCP_READONLY>",
"HOMELAB_MCP_MUTABLE_NAMESPACES": "<your HOMELAB_MCP_MUTABLE_NAMESPACES>",
"HOMELAB_MCP_MAX_REPLICAS": "<your HOMELAB_MCP_MAX_REPLICAS>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json. Replace each placeholder with your own value before saving.
{
"mcpServers": {
"whitecapdata-dev": {
"command": "uvx",
"args": [
"whitecapdata-dev"
],
"env": {
"HOMELAB_MCP_CONTEXT": "<your HOMELAB_MCP_CONTEXT>",
"HOMELAB_MCP_READONLY": "<your HOMELAB_MCP_READONLY>",
"HOMELAB_MCP_MUTABLE_NAMESPACES": "<your HOMELAB_MCP_MUTABLE_NAMESPACES>",
"HOMELAB_MCP_MAX_REPLICAS": "<your HOMELAB_MCP_MAX_REPLICAS>"
}
}
}
}Replace each placeholder with your own value before saving.
Show your rank
Maintain this server? Add the live rank badge to your README — it updates automatically as the leaderboard changes.
[](https://mcptoplist.com/server/io.github.Michael-WhiteCapData%2FWhiteCapData-Dev)<a href="https://mcptoplist.com/server/io.github.Michael-WhiteCapData%2FWhiteCapData-Dev"><img src="https://mcptoplist.com/badge/io.github.Michael-WhiteCapData%2FWhiteCapData-Dev.svg" alt="MCP Toplist: Top 50% of 115,460" /></a>Variants: append ?metric=score or ?metric=stars to the image URL.
Listed on 4 registries
michael-whitecapdata
Other servers by michael-whitecapdata
View all michael-whitecapdata servers →Available versions (1)
| Version | Published |
|---|---|
| 0.1.1 | Jun 21, 2026 |
Frequently asked questions
- Who maintains homelab-mcp?
- homelab-mcp is maintained by michael-whitecapdata, which publishes 3 MCP servers (3 total versions) tracked on MCP Toplist.
- Is homelab-mcp listed on the Official MCP Registry?
- Yes — homelab-mcp is listed on the Official MCP Registry, alongside Glama and PulseMCP.
- How many versions does homelab-mcp have?
- MCP Toplist tracks 1 version of homelab-mcp, most recently published on Jun 21, 2026.
- Where can I find the source code for homelab-mcp?
- The source code for homelab-mcp is hosted at github.com/michael-whitecapdata/whitecapdata-dev.