Skip to main content

MCP Server Configuration

The server reads environment variables, plus a .env file in the package root if one exists (copy .env.dist).

VariableDefaultDescription
LOG_INSPECTOR_PROVIDERopenaiChat model provider: openai, anthropic or ollama
LOG_INSPECTOR_MODELgpt-5.4-mini / claude-sonnet-5-5 / llama3.2Chat model used by the agent and the tool explanations
LOG_INSPECTOR_EMBEDDING_PROVIDERthe chat provider (ollama when it is anthropic)openai or ollama (Anthropic has no embedding models)
LOG_INSPECTOR_EMBEDDING_MODELtext-embedding-3-small / nomic-embed-textEmbedding model for indexing and search
LOG_INSPECTOR_PATHSComma-separated log files or directories (*.log) indexed at startup
OPENAI_API_KEYRequired for openai
ANTHROPIC_API_KEYRequired for anthropic
OLLAMA_HOSThttp://localhost:11434Ollama endpoint (http://host.docker.internal:11434 from Docker)
OLLAMA_TIMEOUT300 (600 in docker-compose)Seconds allowed per Ollama call. Raise it on CPU-only machines

Typical setups​

# OpenAI for everything
OPENAI_API_KEY=sk-... php bin/log-inspector-mcp

# Claude for reasoning, local embeddings
LOG_INSPECTOR_PROVIDER=anthropic ANTHROPIC_API_KEY=sk-ant-... \
LOG_INSPECTOR_EMBEDDING_PROVIDER=ollama php bin/log-inspector-mcp

# Fully local, no API key
ollama pull llama3.2 && ollama pull nomic-embed-text
LOG_INSPECTOR_PROVIDER=ollama php bin/log-inspector-mcp

Configuration errors are written to STDERR and the server exits with code 1. STDOUT stays reserved for the MCP protocol.

Supported log formats​

LogLineParser turns each line into searchable metadata:

FormatExample
Monolog / Symfony / Laravel[2026-11-12 14:20:16] request.ERROR: Checkout failed {"request_id":"req_c1042"} []
Level only[2025-01-15 14:15:23] WARN: Circuit breaker opened {"trace_id":"trace_001"}
PHP error_log[06-Feb-2026 14:22:31 UTC] PHP Fatal error: Uncaught Error: ...
Anything elseindexed as-is (level info, no timestamp), still searchable

Extracted fields: log_id (<file>_<line>, used as the evidence id), level, channel, timestamp (ISO 8601), message, and from the JSON context request_id, trace_id, session_id, span_id and service.