fix: mcp-server naar poort 8050 (v1.7.6)

Portainer gebruikt standaard poort 8000 voor zijn edge-agent-tunnel. De
mcp-server container luisterde ook op 8000 (alleen de host-mapping was
8001), wat op RHEL9 hosts met Portainer tot verwarring en potentiële
conflicten leidde in stack-definities.

Zet intern én extern consistent op 8050 (1:1 mapping 8050:8050) zodat de
service los staat van Portainer's poortreeks. Alle compose-files,
Dockerfile EXPOSE, MCP_PORT env, healthcheck en README bijgewerkt.

Author: Rob Verkuijlen

README.md

@@ -207,11 +207,11 @@ De MCP server (`apps/mcp-server/`) stelt de KVK datamirror beschikbaar voor LLMs
 
 ### Starten
 
-De MCP server draait automatisch mee met Docker Compose op poort 8001:
+De MCP server draait automatisch mee met Docker Compose op poort 8050:
 
 ```bash
 docker compose -f docker-compose.local.yaml up -d
-curl http://localhost:8001/health  # {"status": "ok"}
+curl http://localhost:8050/health  # {"status": "ok"}
 ```
 
 ### Transport
@@ -241,7 +241,7 @@ Voeg toe aan `claude_desktop_config.json` (Settings > Developer > Edit Config):
       "command": "C:\\Program Files\\nodejs\\node.exe",
       "args": [
         "<pad-naar-npm-global>/node_modules/mcp-remote/dist/proxy.js",
-        "http://localhost:8001/mcp"
+        "http://localhost:8050/mcp"
       ]
     }
   }

apps/mcp-server/Dockerfile

@@ -33,6 +33,6 @@ COPY apps/mcp-server ./apps/mcp-server
 ENV PATH=/app/.venv/bin:$PATH \
     PYTHONPATH=/app/src
 
-EXPOSE 8000
+EXPOSE 8050
 
 CMD ["uv", "run", "--no-sync", "python", "apps/mcp-server/main.py"]

apps/mcp-server/main.py

@@ -27,7 +27,7 @@
 logger = logging.getLogger(__name__)
 
 _host = os.getenv("MCP_HOST", "0.0.0.0")
-_port = int(os.getenv("MCP_PORT", "8000"))
+_port = int(os.getenv("MCP_PORT", "8050"))
 mcp = FastMCP("kvk-connect", host=_host, port=_port, stateless_http=True)
 _service: KVKMirrorService | None = None
 

docker-compose.db.yaml

@@ -106,16 +106,16 @@ services:
       - .env.docker
     environment:
       - MCP_TRANSPORT=streamable-http
-      - MCP_PORT=8000
+      - MCP_PORT=8050
     ports:
-      - "8001:8000"
+      - "8050:8050"
     depends_on:
       gateway:
         condition: service_healthy
     networks:
       - kvk-network
     healthcheck:
-      test: ["CMD", "wget", "--quiet", "--tries=1", "--spider", "http://127.0.0.1:8000/health"]
+      test: ["CMD", "wget", "--quiet", "--tries=1", "--spider", "http://127.0.0.1:8050/health"]
       interval: 10s
       timeout: 5s
       retries: 5

docker-compose.local.yaml

@@ -127,16 +127,16 @@ services:
     environment:
       - SQLALCHEMY_DATABASE_URI=postgresql://${POSTGRES_USER}:${POSTGRES_PASSWORD}@postgres:5432/${POSTGRES_DB}
       - MCP_TRANSPORT=streamable-http
-      - MCP_PORT=8000
+      - MCP_PORT=8050
     ports:
-      - "8001:8000"
+      - "8050:8050"
     depends_on:
       postgres:
         condition: service_healthy
     networks:
       - kvk-network
     healthcheck:
-      test: ["CMD", "wget", "--quiet", "--tries=1", "--spider", "http://127.0.0.1:8000/health"]
+      test: ["CMD", "wget", "--quiet", "--tries=1", "--spider", "http://127.0.0.1:8050/health"]
       interval: 10s
       timeout: 5s
       retries: 5

docker-compose.prod.yaml

@@ -111,17 +111,17 @@ services:
     restart: unless-stopped
     environment:
       - MCP_TRANSPORT=streamable-http
-      - MCP_PORT=8000
+      - MCP_PORT=8050
       - SQLALCHEMY_DATABASE_URI=${SQLALCHEMY_DATABASE_URI}
     ports:
-      - "8001:8000"
+      - "8050:8050"
     depends_on:
       gateway:
         condition: service_healthy
     networks:
       - kvk-network
     healthcheck:
-      test: ["CMD", "wget", "--quiet", "--tries=1", "--spider", "http://127.0.0.1:8000/health"]
+      test: ["CMD", "wget", "--quiet", "--tries=1", "--spider", "http://127.0.0.1:8050/health"]
       interval: 10s
       timeout: 5s
       retries: 5

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "kvk-connect"
-version = "1.7.5"
+version = "1.7.6"
 description = "Client + domain mapping for KVK API"
 readme = "README.md"
 requires-python = ">=3.13"

tests/apps/mcp_server/test_tools.py

@@ -66,11 +66,11 @@ def test_main_zet_service_instantie(self, db_engine: Engine, monkeypatch: pytest
         assert isinstance(main._service, KVKMirrorService)
 
     def test_default_host_en_port(self) -> None:
-        """Standaard host is 0.0.0.0 en port 8000 — veilig in Docker."""
+        """Standaard host is 0.0.0.0 en port 8050 — vermijdt conflict met Portainer edge-agent (8000)."""
         import main
 
         assert main._host == os.getenv("MCP_HOST", "0.0.0.0")
-        assert main._port == int(os.getenv("MCP_PORT", "8000"))
+        assert main._port == int(os.getenv("MCP_PORT", "8050"))
 
     def test_transport_configureerbaar_via_env(self, db_engine: Engine, monkeypatch: pytest.MonkeyPatch) -> None:
         """MCP_TRANSPORT env var bepaalt transport modus."""