fix: translate Docker files to English, move bridge+docs to docker/

Author: aborruso

Dockerfile

@@ -3,11 +3,11 @@ FROM node:20-alpine AS builder
 
 WORKDIR /app
 
-# Copia solo i file di dipendenze prima (layer cache)
+# Copy dependency files first (layer cache)
 COPY package*.json ./
 RUN npm ci
 
-# Copia tutto il sorgente e compila
+# Copy source and build
 COPY . .
 RUN npm run build
 
@@ -16,32 +16,29 @@ FROM node:20-alpine AS runtime
 
 WORKDIR /app
 
-# Installa solo le dipendenze di produzione
+# Install production dependencies only
 COPY package*.json ./
 RUN npm ci --omit=dev && npm cache clean --force
 
-# Copia i file compilati dallo stage di build
+# Copy compiled files from build stage
 COPY --from=builder /app/dist ./dist
 
-# Copia eventuali asset statici necessari a runtime (opzionale: il file potrebbe non esistere)
-COPY --from=builder /app/src/portals.jso[n] ./src/
-
-# Variabili d'ambiente con valori di default
+# Default environment variables
 ENV NODE_ENV=production
 ENV TRANSPORT=http
 ENV PORT=3000
 
-# Espone la porta HTTP del server MCP
+# Expose MCP HTTP server port
 EXPOSE 3000
 
-# Healthcheck: verifica che il server risponda
+# Healthcheck: verify the server responds
 HEALTHCHECK --interval=30s --timeout=10s --start-period=15s --retries=3 \
   CMD wget -qO- http://localhost:${PORT}/health 2>/dev/null || \
       curl -sf -X POST http://localhost:${PORT}/mcp \
         -H 'Content-Type: application/json' \
         -d '{"jsonrpc":"2.0","method":"ping","id":1}' || exit 1
 
-# Utente non-root per sicurezza
+# Run as non-root user for security
 USER node
 
 CMD ["node", "dist/index.js"]

docker-compose.yml

@@ -11,22 +11,22 @@ services:
       - "3000:3000"
 
     environment:
-      # Modalità di trasporto: "http" per server HTTP, "stdio" per pipe locale
+      # Transport mode: "http" for HTTP server, "stdio" for local pipe
       TRANSPORT: http
       PORT: 3000
       NODE_ENV: production
 
-      # Opzionale: imposta un CKAN portal di default
+      # Optional: set a default CKAN portal
       # CKAN_DEFAULT_SERVER_URL: https://www.dati.gov.it/opendata
 
-    # Limiti di risorse (opzionale, regola in base al tuo host)
+    # Resource limits (optional, adjust to your host)
     deploy:
       resources:
         limits:
           memory: 256M
           cpus: "0.5"
 
-    # Log con rotazione automatica
+    # Automatic log rotation
     logging:
       driver: "json-file"
       options:

DOCKER-README.md docker/README.mdDOCKER-README.md renamed to docker/README.md

@@ -4,13 +4,15 @@ These files allow you to run [ckan-mcp-server](https://github.com/ondata/ckan-mc
 
 ## File Structure
 
-Copy these three files into the root of the repo:
+The following files are included in the repo:
 
 ```
 ckan-mcp-server/
-├── Dockerfile          ← multi-stage build (builder + runtime)
-├── docker-compose.yml  ← orchestration with variables and healthcheck
-├── .dockerignore       ← excludes node_modules, dist, docs, etc.
+├── Dockerfile               ← multi-stage build (builder + runtime)
+├── docker-compose.yml       ← orchestration with variables and healthcheck
+├── docker/
+│   ├── README.md            ← this file
+│   └── ckan-mcp-bridge.js   ← stdio bridge for Claude Desktop
 └── ... (rest of the repo)
 ```
 
@@ -21,10 +23,7 @@ ckan-mcp-server/
 git clone https://github.com/ondata/ckan-mcp-server.git
 cd ckan-mcp-server
 
-# 2. Copy the Docker files into the repo root
-#    (Dockerfile, docker-compose.yml, .dockerignore)
-
-# 3. Build and start
+# 2. Build and start
 docker compose up --build -d
 ```
 
@@ -56,16 +55,15 @@ docker run -d \
 
 ## Configuring Claude Desktop with the Container
 
-Save ckan-mcp-bridge.js (config your local IP if necessary instead localhost in row 14)
-
-Once the container is running, add the following to `claude_desktop_config.json`:
+Once the container is running, add the following to `claude_desktop_config.json`.
+Set `MCP_URL` to point to your Docker host if running on a remote machine.
 
 ```json
 {
   "mcpServers": {
     "ckan": {
       "command": "node",
-      "args": ["/usr/local/bin/ckan-mcp-bridge.js"],
+      "args": ["/path/to/ckan-mcp-server/docker/ckan-mcp-bridge.js"],
       "env": {
         "MCP_URL": "http://localhost:3000/mcp"
       }

ckan-mcp-bridge.js docker/ckan-mcp-bridge.jsckan-mcp-bridge.js renamed to docker/ckan-mcp-bridge.js

@@ -1,16 +1,15 @@
 #!/usr/bin/env node
 /**
- * stdio-bridge.js
- * Wrapper che permette a Claude Desktop (stdio) di parlare
- * con il container ckan-mcp-server (HTTP/SSE).
+ * ckan-mcp-bridge.js
+ * Wrapper that allows Claude Desktop (stdio) to communicate
+ * with the ckan-mcp-server container (HTTP/SSE).
  *
- * Claude Desktop <--stdio--> questo script <--HTTP--> container Docker
+ * Claude Desktop <--stdio--> this script <--HTTP--> Docker container
  */
 
 const http = require("http");
 const https = require("https");
 
-/*CHANGE LOCALHOST WITH IP*/
 const MCP_URL = process.env.MCP_URL || "http://localhost:3000/mcp";
 
 const url = new URL(MCP_URL);
@@ -35,7 +34,7 @@ function sendToServer(body) {
       let raw = "";
       res.on("data", (chunk) => (raw += chunk));
       res.on("end", () => {
-        // Gestisce sia risposte JSON pure che SSE (data: {...})
+        // Handle both plain JSON responses and SSE (data: {...})
         const lines = raw.split("\n");
         for (const line of lines) {
           const trimmed = line.trim();
@@ -54,7 +53,7 @@ function sendToServer(body) {
             } catch {}
           }
         }
-        // Fallback: prova a parsare tutto il body
+        // Fallback: try to parse the entire body
         try {
           resolve(JSON.parse(raw));
         } catch {
@@ -69,13 +68,13 @@ function sendToServer(body) {
   });
 }
 
-// Legge messaggi JSON-RPC da stdin (uno per riga)
+// Read JSON-RPC messages from stdin (one per line)
 let buffer = "";
 process.stdin.setEncoding("utf8");
 process.stdin.on("data", async (chunk) => {
   buffer += chunk;
   const lines = buffer.split("\n");
-  buffer = lines.pop(); // l'ultima riga potrebbe essere incompleta
+  buffer = lines.pop(); // last line may be incomplete
 
   for (const line of lines) {
     const trimmed = line.trim();
@@ -85,7 +84,7 @@ process.stdin.on("data", async (chunk) => {
       const response = await sendToServer(message);
       process.stdout.write(JSON.stringify(response) + "\n");
     } catch (err) {
-      // Invia un errore JSON-RPC valido in caso di problema
+      // Send a valid JSON-RPC error on failure
       const errResponse = {
         jsonrpc: "2.0",
         error: { code: -32603, message: err.message },