Skip to content
SafeLLM

MCP Reference

MCP Reference Deployment

Section titled “MCP Reference Deployment”

This deployment is a minimal Docker stack for testing SafeLLM MCP tooling together with the sidecar HTTP API.

What is included

Section titled “What is included”
  • SafeLLM sidecar (OSS build)
  • Redis cache backend
  • Smoke test script covering HTTP and MCP paths

Repository path:

  • safellm-oss/examples/mcp-reference/

Quick Start

Section titled “Quick Start”
Terminal window
cd safellm-oss/examples/mcp-reference
cp .env.example .env
docker compose up -d --build
bash smoke-test.sh

What the smoke test validates

Section titled “What the smoke test validates”
  1. GET /health on sidecar
  2. POST /v1/guard with clean content
  3. POST /v1/guard with malicious content (blocked when SHADOW_MODE=false)
  4. MCP tools/list contains built-in tools
  5. MCP tools/call returns structured result

Manual MCP command

Section titled “Manual MCP command”
Terminal window
docker compose exec -T sidecar sh -lc \
  "printf '%s\\n' '{\"jsonrpc\":\"2.0\",\"id\":2,\"method\":\"tools/list\",\"params\":{}}' | python -m sidecar.mcp"

Tuning

Section titled “Tuning”
  • SIDECAR_HTTP_PORT (default 18000)
  • SHADOW_MODE (default false in .env.example)

Cleanup

Section titled “Cleanup”
Terminal window
docker compose down -v