Install guide · Cursor
Install homelab-infra-mcp for Cursor
Cursor reads ~/.cursor/mcp.json. A project can also commit .cursor/mcp.json.
Add to Cursor: homelab-infra-mcpInstall in VS Code: homelab-infra-mcpInstall in VS Code Insiders: homelab-infra-mcp
Needs Cursor or VS Code installed on this device. The button opens the app and asks you to confirm before it adds the server.
Open ~/.cursor/mcp.json on macOS, %USERPROFILE%\.cursor\mcp.json on Windows, or ~/.cursor/mcp.json on Linux.
Paste the JSON config below.
Replace placeholder secrets, then restart the client if it does not reload on its own.
{ "mcpServers": { "seayniclabs-homelab-infra-mcp": { "command": "uvx", "args": [ "homelab-infra-mcp" ], "env": { "HOMELAB_PROXY_URL": "", "HOMELAB_PROXY_EMAIL": "", "HOMELAB_PROXY_PASSWORD": "YOUR_HOMELAB_PROXY_PASSWORD", "HOMELAB_DOCKER_HOST": "", "HOMELAB_DOCKER_PORTAINER_URL": "", "HOMELAB_DOCKER_PORTAINER_TOKEN": "YOUR_HOMELAB_DOCKER_PORTAINER_TOKEN", "HOMELAB_DOCKER_PORTAINER_ENDPOINT_ID": "", "HOMELAB_DNS_API_TOKEN": "YOUR_HOMELAB_DNS_API_TOKEN", "HOMELAB_DNS_ZONE_ID": "", "HOMELAB_HOME_ASSISTANT_URL": "", "HOMELAB_HOME_ASSISTANT_TOKEN": "YOUR_HOMELAB_HOME_ASSISTANT_TOKEN", "HOMELAB_UPTIME_ENABLED": "", "HOMELAB_UPTIME_URL": "", "HOMELAB_UPTIME_API_KEY": "YOUR_HOMELAB_UPTIME_API_KEY", "HOMELAB_TUNNEL_ENABLED": "", "HOMELAB_TUNNEL_API_TOKEN": "YOUR_HOMELAB_TUNNEL_API_TOKEN", "HOMELAB_TUNNEL_ACCOUNT_ID": "", "HOMELAB_TUNNEL_TUNNEL_ID": "", "HOMELAB_DNS_FILTER_ENABLED": "", "HOMELAB_DNS_FILTER_URL": "", "HOMELAB_DNS_FILTER_USERNAME": "", "HOMELAB_DNS_FILTER_PASSWORD": "YOUR_HOMELAB_DNS_FILTER_PASSWORD", "HOMELAB_SSO_ENABLED": "", "HOMELAB_SSO_URL": "", "HOMELAB_SSO_TOKEN": "YOUR_HOMELAB_SSO_TOKEN", "HOMELAB_SSO_FLOW_SLUG": "", "HOMELAB_READ_ONLY": "" } } }}
Where the config lives
| System | Path |
|---|---|
| macOS | ~/.cursor/mcp.json |
| Windows | %USERPROFILE%\.cursor\mcp.json |
| Linux | ~/.cursor/mcp.json |