Add Docker support, Neo4j integration, and enhance server functionality

.dockerignore

@@ -0,0 +1,76 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual environments
+.venv
+venv/
+ENV/
+env/
+
+# IDEs
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.DS_Store
+
+# Testing and coverage
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+.nox/
+coverage.xml
+*.cover
+*.py,cover
+tests/
+
+# Linting and formatting
+.ruff_cache/
+.mypy_cache/
+.pyright/
+
+# Build tools
+.hatch/
+.hypothesis/
+
+# Documentation
+docs/_build/
+
+# CI/CD
+.github/
+.gitlab-ci.yml
+
+# Config files
+.env
+.env.*
+*.env
+
+# Notes and temporary files
+notes.md
+demo.md
+*.md.backup
+
+# Development docs
+DEVELOPMENT.md
+CONTRIBUTING.md

.gitlab-ci.yml

@@ -0,0 +1,28 @@
+docker_build:
+  stage: build
+  image:
+    name: gcr.io/kaniko-project/executor:debug
+    entrypoint: [""]
+  script:
+    - |
+      mkdir -p /kaniko/.docker
+    - echo "{\"auths\":{\"$CI_REGISTRY\":{\"username\":\"$CI_REGISTRY_USER\",\"password\":\"$CI_REGISTRY_PASSWORD\"}}}" > /kaniko/.docker/config.json
+    - /kaniko/executor --context $CI_PROJECT_DIR --destination ${CI_REGISTRY_IMAGE}/app:$CI_COMMIT_SHORT_SHA
+  tags:
+    - pdbe-docker
+
+trigger_deploy:
+  stage: deploy
+  inherit:
+    variables: false
+  variables:
+    UPSTREAM_REF: $CI_COMMIT_REF_NAME
+    IMAGE_PATHS: ${CI_REGISTRY_IMAGE}/app:$CI_COMMIT_SHORT_SHA
+    IMAGE_NAMES: pdbe-mcp-server
+    APP_NAME: pdbe-mcp-server
+  trigger:
+    project: pdbe/backend/k8s-deploy-configs
+    branch: main
+    strategy: depend
+  needs:
+    - docker_build

Dockerfile

@@ -0,0 +1,26 @@
+# Single-stage Dockerfile for MCP remote server using uv
+FROM python:3.11-slim
+
+# Install uv
+RUN pip install uv
+
+WORKDIR /app
+
+# Copy only necessary files first for better caching
+COPY pyproject.toml README.md ./
+COPY pdbe_mcp_server/py.typed ./pdbe_mcp_server/py.typed
+
+# Create a virtual environment
+RUN uv venv
+
+# Install dependencies using uv pip install
+RUN uv pip install --no-cache-dir .
+
+# Copy application source
+COPY pdbe_mcp_server/ ./pdbe_mcp_server/
+
+# Expose port
+EXPOSE 8000
+
+# Run with uv
+CMD ["uv", "run", "pdbe-mcp-remote-server", "--host", "0.0.0.0", "--port", "8000"]

README.md

@@ -235,6 +235,21 @@ Common searchable fields include:
 Use `get_search_schema` to discover all available fields and their descriptions.
 
 ## Development and Advanced Usage
+### Docker (single container with Nginx)
+
+Build and run all three MCP servers behind Nginx using the included Dockerfile:
+
+```bash
+docker build -t pdbe-mcp-servers:latest .
+docker run --rm -p 8080:8080 pdbe-mcp-servers:latest
+```
+
+Endpoints:
+- `http://localhost:8080/api/sse` and `http://localhost:8080/api/messages/`
+- `http://localhost:8080/graph/sse` and `http://localhost:8080/graph/messages/`
+- `http://localhost:8080/search/sse` and `http://localhost:8080/search/messages/`
+- Health: `http://localhost:8080/health`
+
 
 ### Development Installation
 
@@ -281,7 +296,7 @@ uv run pdbe-mcp-server --server-type pdbe_graph_server --transport sse
 
 This server supports executing custom Cypher queries against a Neo4j graph database. The `pdbe_run_cypher_query` tool is only available when the following environment variables are set:
 
-- `NEO4J_URL`: The Neo4j database URL (e.g., `bolt://localhost:7687`)
+- `NEO4J_URI`: The Neo4j database URL (e.g., `bolt://localhost:7687`)
 - `NEO4J_USERNAME`: The Neo4j username
 - `NEO4J_PASSWORD`: The Neo4j password
 - `NEO4J_DATABASE` (optional): The database name. When set, this is passed to the Neo4j driver for Neo4j 4+. For Neo4j 3.5 compatibility, omit this variable to use the default database.