intellicrack.mcp.server_logs

Log messages MCP servers send, routed into Intellicrack’s own logging.

A server may send notifications/message log records: on a 2025-11-25 connection at or above the level logging/setLevel asked for, and on a 2026-07-28 connection only for requests that opt in with a logLevel in their _meta. Every record is the server’s own text, so it is cleaned of invisible characters and forged fence markers and bounded before it is logged. Each record goes to the structlog pipeline – and so to the log files and the log viewer – with the server it came from, its level mapped onto structlog’s, and is kept in a bounded per-server buffer the MCP settings show. A server that floods is rate limited per server; what it sends over the limit is counted, not logged, and the count is reported once the limit allows.

LOG_RECORD_TEXT_LIMIT: Final[int] = 4000

Longest record text kept, in characters.

DEFAULT_BUFFER_RECORDS: Final[int] = 500

Records kept per server for the settings view.

DEFAULT_RATE_PER_S: Final[float] = 20.0

Records per second a server may log once its burst is spent.

DEFAULT_BURST: Final[int] = 100

Records a server may log at once before the rate applies.

class McpLogRecord

Bases: object

One log message a server sent, cleaned for display.

Variables:

• received_at (datetime) – When it arrived.

• server_id (str) – The server that sent it.

• level (str) – Its protocol level, such as warning.

• logger (str | None) – The server-side logger name it gave, if any.

• text (str) – Its data, rendered as text and cleaned.

received_at: datetime

server_id: str

level: str

logger: str | None

text: str

render()

Render the record as one line of the settings view.

Returns:

time level [logger] text.

Return type:

str

__init__(received_at, server_id, level, logger, text)

Parameters:

• received_at (datetime)

• server_id (str)

• level (str)

• logger (str | None)

• text (str)

Return type:

None

render_log_data(data)

Render a record’s data, which may be any JSON value, as text.

Parameters:

data (object) – The record’s data.

Returns:

A string as it is, anything else as compact JSON.

Return type:

str

class McpServerLogBook

Bases: object

Receives every server’s log messages and keeps each server’s recent ones.

Callbacks are invoked on the MCP event loop and listeners are called there too; a GUI listener must hand the record to its own thread.

__init__(*, capacity=500, rate_per_s=20.0, burst=100, clock=<built-in function monotonic>)

Create an empty log book.

Parameters:

• capacity (int) – Records kept per server.

• rate_per_s (float) – Records per second a server may log after its burst.

• burst (int) – Records a server may log at once.

• clock (Callable[[], float]) – Monotonic clock the rate limit reads.

Return type:

None

callback_for(server_id)

Build the SDK logging callback for one server.

Parameters:

server_id (str) – The server the callback receives messages from.

Returns:

The callback.

Return type:

LoggingFnT

receive(server_id, level, logger, data)

Log, keep and announce one message, unless the server is over its rate.

Parameters:

• server_id (str) – The server that sent it.

• level (str) – Its protocol level.

• logger (str | None) – Its logger name, if any.

• data (object) – Its data.

Returns:

The record, or None when it was rate limited.

Return type:

McpLogRecord | None

records(server_id)

Return a server’s recent records.

Parameters:

server_id (str) – The server.

Returns:

Its records, oldest first.

Return type:

list[McpLogRecord]

suppressed(server_id)

Report how many of a server’s records are being held back by its rate limit.

Parameters:

server_id (str) – The server.

Returns:

Records dropped since its last logged one.

Return type:

int

add_listener(listener)

Call a function for every record kept from now on.

Parameters:

listener (Callable[[McpLogRecord], None]) – Receives each record, on the MCP event loop.

Return type:

None

remove_listener(listener)

Stop calling a listener.

Parameters:

listener (Callable[[McpLogRecord], None]) – A listener added earlier.

Return type:

None