feat: Add Streamable HTTP server for Claude.ai Connectors

Add new Streamable HTTP transport server compatible with Claude.ai Connectors:

- Add streamable_http_server.py with multi-user support
- Add user_config.py for JSON-based user configuration
- Add config/users.example.json as configuration template
- Add kimai-mcp-streamable entrypoint
- Update Dockerfile to use new server by default
- Update docker-compose.yml for user config volume mount

This enables the MCP server to work as a remote connector in Claude.ai,
allowing access from web and mobile clients. Each user gets their own
endpoint (/mcp/{user_slug}) with server-side Kimai credentials.

🤖 Generated with [Claude Code](https://claude.ai/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: glazperle

Dockerfile

@@ -28,6 +28,9 @@ COPY --from=builder /usr/local/lib/python3.11/site-packages /usr/local/lib/pytho
 COPY --from=builder /usr/local/bin /usr/local/bin
 COPY --from=builder /app /app
 
+# Create config directory
+RUN mkdir -p /app/config
+
 # Create non-root user
 RUN useradd -m -u 1000 -s /bin/bash kimai && \
     chown -R kimai:kimai /app
@@ -42,5 +45,6 @@ EXPOSE 8000
 HEALTHCHECK --interval=30s --timeout=10s --start-period=5s --retries=3 \
     CMD python -c "import urllib.request; urllib.request.urlopen('http://localhost:8000/health')"
 
-# Run the server
-CMD ["kimai-mcp-server"]
+# Default: Run the new Streamable HTTP server (for Claude.ai Connectors)
+# Use kimai-mcp-server for the legacy SSE server
+CMD ["kimai-mcp-streamable"]

config/users.example.json

@@ -0,0 +1,14 @@
+{
+  "max": {
+    "kimai_url": "https://kimai.example.com",
+    "kimai_token": "your-api-token-for-max",
+    "kimai_user_id": "1",
+    "ssl_verify": true
+  },
+  "anna": {
+    "kimai_url": "https://kimai.example.com",
+    "kimai_token": "your-api-token-for-anna",
+    "kimai_user_id": "2",
+    "ssl_verify": true
+  }
+}

docker-compose.yml

@@ -10,11 +10,8 @@ services:
 
     # Environment variables
     environment:
-      # MCP Server authentication (optional - auto-generated if not set)
-      - MCP_SERVER_TOKEN=${MCP_SERVER_TOKEN:-}
-
-      # Optional: Default Kimai URL (clients can override)
-      - DEFAULT_KIMAI_URL=${DEFAULT_KIMAI_URL:-}
+      # Path to users config file (inside container)
+      - USERS_CONFIG_FILE=/app/config/users.json
 
       # SSL verification for Kimai connections
       - KIMAI_SSL_VERIFY=${KIMAI_SSL_VERIFY:-true}
@@ -23,9 +20,11 @@ services:
     ports:
       - "${SERVER_PORT:-8000}:8000"
 
-    # Optional: Mount CA certificates for custom SSL
-    # volumes:
-    #   - ./certs/ca-bundle.crt:/app/certs/ca-bundle.crt:ro
+    # Mount the users config file
+    volumes:
+      - ./config/users.json:/app/config/users.json:ro
+      # Optional: Mount CA certificates for custom SSL
+      # - ./certs/ca-bundle.crt:/app/certs/ca-bundle.crt:ro
 
     # Health check
     healthcheck:

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "kimai-mcp"
-version = "2.7.1"
+version = "2.8.0"
 description = "MCP server for Kimai time-tracking API integration"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -54,6 +54,7 @@ Repository = "https://github.com/glazperle/kimai_mcp"
 [project.scripts]
 kimai-mcp = "kimai_mcp.server:entrypoint"
 kimai-mcp-server = "kimai_mcp.sse_server:main"
+kimai-mcp-streamable = "kimai_mcp.streamable_http_server:main"
 
 [tool.hatch.build.targets.wheel]
 packages = ["src/kimai_mcp"]

src/kimai_mcp/server.py

@@ -11,7 +11,7 @@
 from pathlib import Path
 from typing import Any, Dict, List, Optional, Union
 
-__version__ = "2.7.1"
+__version__ = "2.8.0"
 
 # Load environment variables from .env file if it exists
 try: