diff --git a/graph/configurations/docker-mcp-gateway-deployed-on-lxc-303-mcp-gateway-10100231-12689c.md b/graph/configurations/docker-mcp-gateway-deployed-on-lxc-303-mcp-gateway-10100231-12689c.md new file mode 100644 index 00000000000..07989d97b59 --- /dev/null +++ b/graph/configurations/docker-mcp-gateway-deployed-on-lxc-303-mcp-gateway-10100231-12689c.md @@ -0,0 +1,65 @@ +--- +id: 12689cf6-7102-4428-981b-4a0e211c4d87 +type: configuration +title: "Docker MCP Gateway deployed on LXC 303 (mcp-gateway, 10.10.0.231)" +tags: [docker, mcp, mcp-gateway, proxmox, homelab, lxc, configuration] +importance: 0.8 +confidence: 0.8 +created: "2026-02-25T21:55:11.210733+00:00" +updated: "2026-02-25T21:55:11.210733+00:00" +--- + +# Docker MCP Gateway on LXC 303 + +## Infrastructure + +- **VMID:** 303 +- **Hostname:** mcp-gateway +- **IP:** 10.10.0.231 +- **OS:** Ubuntu 24.04 +- **Resources:** 2 cores, 4GB RAM, 16GB disk +- **Type:** Privileged LXC on Proxmox +- **SSH alias:** `mcp-gateway` + +## Purpose + +Centralized Docker MCP Gateway service hosting 220+ catalog MCP servers. AI clients (e.g. Claude Code) connect to a single HTTP endpoint and can discover/enable tools on the fly via dynamic tools: `mcp-find`, `mcp-add`, `mcp-remove`. + +## Deployment + +- Docker CE installed on LXC +- Container: `docker/mcp-gateway` +- Compose file: `/opt/mcp-gateway/docker-compose.yml` +- Flags: `--transport=streaming --port=8811` +- Endpoint: `http://10.10.0.231:8811/mcp` + +## AppArmor Fix for Docker-in-LXC + +Required these lines in `/etc/pve/lxc/303.conf`: + +``` +lxc.apparmor.profile: unconfined +lxc.cap.drop: +lxc.mount.auto: proc:rw sys:rw +``` + +Without these, Docker cannot start inside a privileged LXC due to AppArmor restrictions. + +## Claude Code Integration + +Registered as user-scope MCP server: + +```bash +claude mcp add --transport http --scope user docker-mcp-gateway http://10.10.0.231:8811/mcp +``` + +Adds the following to `~/.claude.json` mcpServers: + +```json +{ + "docker-mcp-gateway": { + "type": "http", + "url": "http://10.10.0.231:8811/mcp" + } +} +```