diff --git a/graph/decisions/migrated-from-docker-mcp-gateway-lxc-303-back-to-local-mcp-s-670b71.md b/graph/decisions/migrated-from-docker-mcp-gateway-lxc-303-back-to-local-mcp-s-670b71.md new file mode 100644 index 00000000000..28dcbe8dd71 --- /dev/null +++ b/graph/decisions/migrated-from-docker-mcp-gateway-lxc-303-back-to-local-mcp-s-670b71.md @@ -0,0 +1,40 @@ +--- +id: 670b7192-c7b1-4a82-826a-5d0018dd04a9 +type: decision +title: "Migrated from Docker MCP Gateway (LXC 303) back to local MCP servers" +tags: [mcp, docker-mcp-gateway, claude-code, homelab, migration, claude-home] +importance: 0.8 +confidence: 0.8 +created: "2026-02-25T18:40:27.568161+00:00" +updated: "2026-02-25T18:40:27.568161+00:00" +--- + +# Decision: Decommission Docker MCP Gateway, Use Local MCP Servers + +## Context + +LXC 303 (10.10.0.231) was running Docker MCP Gateway serving n8n and Gitea MCP servers via HTTP at `http://10.10.0.231:8811/mcp`. The n8n MCP was already duplicated locally, and maintaining a remote LXC for MCP servers added unnecessary infrastructure overhead. + +## Decision + +Decommissioned Docker MCP Gateway on LXC 303. Replaced the remote HTTP MCP connection with local stdio servers for all tools. + +## Changes Made + +- Removed `docker-mcp-gateway` entry (`http://10.10.0.231:8811/mcp`) from `~/.claude.json` +- Added `@boringstudio_org/gitea-mcp` (npm, v1.8.0) as local stdio replacement for Gitea MCP +- LXC 303 stopped and autostart disabled on Proxmox +- Commit: `5ff94a9` + +## Final Global MCP Config (`~/.claude.json` mcpServers) + +- `cognitive-memory` — python3 stdio +- `n8n-mcp` — npx stdio +- `gitea-mcp` — npx @boringstudio_org/gitea-mcp stdio + +## Rationale + +- Simpler: no remote HTTP dependency, no LXC to maintain +- n8n MCP was already running locally (duplicate) +- Local stdio servers start on demand, no persistent process needed +- Reduces homelab resource usage (LXC 303 freed up)