McpProtocol.h header

bool ew::app::McpRequest::valid = false

True when the line parsed to a JSON-RPC message shape; false leaves parseError set.

QString ew::app::McpRequest::parseError

Why the line failed to parse (when not valid).

bool ew::app::McpRequest::isNotification = false

True when the message carries no "id" (a notification – fire-and-forget).

QJsonValue ew::app::McpRequest::id

The request id to echo in the response (number or string, as the client sent it).

QString ew::app::McpRequest::method

The JSON-RPC method ("initialize", "tools/list", "tools/call", "ping", ...).

QJsonObject ew::app::McpRequest::params

The "params" object (empty when the request carries none).

ew::app::McpServer::McpServer(QString name, QString version, QString instructions)

A server presenting itself as name / version; instructions (may be empty) is surfaced to the client on initialize to teach the assistant the project idiom.

void ew::app::McpServer::registerTool(McpToolSpec spec, McpToolHandler handler)

Adds spec to the advertised catalogue with handler as its implementation. A re-registered name replaces its handler and keeps the original list position.

std::optional< QString > ew::app::McpServer::handleLine(const QString &line)

Handles one stdio line: returns the single-line response to write back, or nothing when the line must not be answered (a notification, or a blank line).

void ew::app::McpServer::setBeforeToolCall(std::function< void(const QString &toolName)> hook)

Registers a hook run immediately before each dispatched tool call, given the tool's name – after the tool is resolved but before it executes, and for every tool (read or write). The server uses it to reload the project from disk when another writer (the desktop app) changed it, so a read reflects current data and a write never clobbers it (docs/MCP_SERVER.md §4). The router does no I/O itself, which is what keeps it unit-testable; any freshness side effect belongs in this hook. A single hook – re-setting replaces it; passing an empty function clears it.

const std::vector< McpToolSpec > & ew::app::McpServer::tools() const

The advertised tool catalogue, in registration order.

bool ew::app::McpToolResult::ok = false

True when the tool did its work (or was a valid no-op).

QString ew::app::McpToolResult::text

The human-readable outcome (compact Markdown, names-first).

QString ew::app::McpToolSpec::name

The tool's wire name (snake_case, e.g. "create_entity").

QString ew::app::McpToolSpec::description

What the tool does, written for the model that will decide to call it.

QJsonObject ew::app::McpToolSpec::inputSchema

The JSON-Schema object describing the tool's arguments.