Deployment
ra-mcp can be deployed as a Docker container, via Helm, or on Hugging Face Spaces.
Docker
docker run -p 7860:7860 riksarkivet/ra-mcp:latest
Available image variants:
| Tag suffix | Base image | Notes |
|---|---|---|
-alpine |
python:3.13-alpine |
Lightweight (default) |
-wolfi |
cgr.dev/chainguard/python:latest-dev |
Minimal CVEs |
-slim |
python:3.13-slim |
Debian slim |
Docker Compose (via Dagger)
# Start server (exposed on host port 7860)
dagger call compose-up up --ports 7860:7860
# Run health check
dagger call compose-test
Connect to Claude Code
# 1. Start the server
dagger call compose-up up --ports 7860:7860
# 2. Add as MCP server
claude mcp add --transport http ra-mcp http://localhost:7860/mcp
# 3. Verify
/mcp
Helm
helm install ra-mcp charts/ra-mcp \
--set image.tag=v0.8.0-alpine \
--set opentelemetry.enabled=true
See charts/ra-mcp/ for the full values reference (autoscaling, ingress, PDB, security contexts).
Hugging Face Spaces
The hosted instance runs at:
https://riksarkivet-ra-mcp.hf.space/mcp
Health Endpoints
Available when running with HTTP transport:
| Endpoint | Purpose |
|---|---|
/health |
Liveness — always returns {"status": "ok"} |
/ready |
Readiness — returns mounted modules or 503 if none loaded |
curl http://localhost:7860/health
curl http://localhost:7860/ready