Collaboration diagram for MCPServer:

Public Member Functions
	__construct ($db, $conf, $user)
	Constructor.

	getHttpStatus ()
	HTTP status code the transport must use for the last handled request.

	validateTransportHeaders (array $headers, array $request)
	Validate the spec 2026-07-28 transport headers against the request body.

	handleRequest (array $request)
	JSON-RPC 2.0 Router.

Private Member Functions
	handleInitialize (array $params)
	Handles the 'initialize' request.

	serverCapabilities ()
	Capabilities shared by initialize and server/discover.

	handleDiscover ()
	Handles the 'server/discover' request (spec 2026-07-28, mandatory).

	handleToolsList ()
	Handles the 'tools/list' request by delegating to McpHandler.

	handleToolCall (array $params)
	Handles the 'tools/call' request by delegating to McpHandler.

	handleResourcesList ()
	Handles the 'resources/list' request.

	handleResourceRead (array $params)
	Handles the 'resources/read' request.

	handlePromptsList ()
	Handles the 'prompts/list' request.

	handlePromptGet (array $params)
	Handles the 'prompts/get' request.

	successResponse ($result)
	Creates a successful JSON-RPC response.

	errorResponse (int $code, string $message, $data=null)
	Creates an error JSON-RPC response.

Detailed Description

MCPServer Class.

This class acts as a thin protocol layer for the Model Context Protocol. It handles JSON-RPC 2.0 requests and delegates all tool-related operations (discovery, loading, execution) to McpHandler engine.

Instantiates McpHandler with CTX_MCP_SERVER so that the public allow-list (AI_MCP_SERVER_ALLOWED_TOOLS) is applied — tools disabled by the admin are invisible in tools/list responses and blocked at tools/call execution.

Definition at line 42 of file mcp_protocol.class.php.

Constructor & Destructor Documentation

◆ __construct()

MCPServer::__construct	(	$db,
		$conf,
		$user )

Constructor.

Parameters

DoliDB	$db	Database handler object
Conf	$conf	Configuration object
User	$user	User object

Definition at line 80 of file mcp_protocol.class.php.

References conf(), and user.

Member Function Documentation

◆ errorResponse()

MCPServer::errorResponse	(	int	$code,
		string	$message,
			$data = null )

private

Creates an error JSON-RPC response.

Parameters

int	$code	The error code.
string	$message	The error message.
mixed	$data	Optional error data.

Returns: array{jsonrpc: string, id: int|string, error: array{code: int, message: string, data?: mixed}}|null The formatted JSON-RPC error response, or null for notifications.

Definition at line 537 of file mcp_protocol.class.php.

Referenced by handleRequest(), and validateTransportHeaders().

◆ getHttpStatus()

MCPServer::getHttpStatus ( )

HTTP status code the transport must use for the last handled request.

Returns: int 200, or 400 for HeaderMismatchError / UnsupportedProtocolVersionError

Definition at line 98 of file mcp_protocol.class.php.

◆ handleDiscover()

MCPServer::handleDiscover ( )

private

Handles the 'server/discover' request (spec 2026-07-28, mandatory).

All fields below are required by the DiscoverResult schema; resultType is injected by successResponse() like on every other result.

Returns: array{supportedVersions: string[], capabilities: array<string, mixed>, cacheScope: string, ttlMs: int, instructions: string}

Definition at line 285 of file mcp_protocol.class.php.

References serverCapabilities().

Referenced by handleRequest().

◆ handleInitialize()

MCPServer::handleInitialize ( array $params )

private

Handles the 'initialize' request.

Parameters

array<string,mixed> $params Initialization parameters from the client.

Returns: array{protocolVersion: string, capabilities: array{tools: array{listChanged: bool}, resources: array{subscribe: bool, listChanged: bool}, prompts: array{listChanged: bool}}, serverInfo: array{name: string, version: string}} Server capabilities and info.

Definition at line 245 of file mcp_protocol.class.php.

References serverCapabilities().

Referenced by handleRequest().

◆ handlePromptGet()

MCPServer::handlePromptGet ( array $params )

private

Handles the 'prompts/get' request.

Parameters

array{name? string, arguments?: array<string, mixed>} $params Parameters containing the prompt name and arguments.

Returns: array{messages: array<int, array{role: string, content: array{type: string, text: string}}>} A list of messages forming the prompt.

Exceptions

Exception If the prompt name is not found.

Definition at line 450 of file mcp_protocol.class.php.

References $prod.

Referenced by handleRequest().

◆ handlePromptsList()

MCPServer::handlePromptsList ( )

private

Handles the 'prompts/list' request.

Returns: array{prompts: array<int, array{name: string, description: string, arguments: array<int, array{name: string, description: string, required: bool}>}>} A list of available prompt templates.

Definition at line 430 of file mcp_protocol.class.php.

Referenced by handleRequest().

◆ handleRequest()

MCPServer::handleRequest ( array $request )

JSON-RPC 2.0 Router.

Routes incoming requests to the appropriate handler method.

Parameters

array{jsonrpc? string, method?: string, params?: array<mixed>, id?: string|int|null} $request The decoded JSON-RPC request array.

Returns: array{jsonrpc: string, id: string|int|null, result?: mixed, error?: array<string, mixed>}|null A JSON-RPC response array, or null for notifications.

Exceptions

Exception On processing errors.

Definition at line 165 of file mcp_protocol.class.php.

References dol_syslog(), errorResponse(), handleDiscover(), handleInitialize(), handlePromptGet(), handlePromptsList(), handleResourceRead(), handleResourcesList(), handleToolCall(), handleToolsList(), and successResponse().

◆ handleResourceRead()

MCPServer::handleResourceRead ( array $params )

private

Handles the 'resources/read' request.

Parameters

array{uri? string} $params Parameters containing the URI of the resource to read.

Returns: array{contents: array<int, array{uri: string, mimeType: string, text: string}>} The content of the requested resource.

Exceptions

Exception If the resource URI is not found.

Definition at line 395 of file mcp_protocol.class.php.

References conf(), and user.

Referenced by handleRequest().

◆ handleResourcesList()

MCPServer::handleResourcesList ( )

private

Handles the 'resources/list' request.

Returns: array{resources: array<int, array{uri: string, name: string, description: string, mimeType: string}>} A list of available static resources.

Definition at line 370 of file mcp_protocol.class.php.

Referenced by handleRequest().

◆ handleToolCall()

MCPServer::handleToolCall ( array $params )

private

Handles the 'tools/call' request by delegating to McpHandler.

Execution is blocked for any tool not in AI_MCP_SERVER_ALLOWED_TOOLS, even if the client sends the request directly without consulting tools/list.

Parameters

array{name? string, arguments?: array<string, mixed>} $params Parameters containing the tool name and arguments.

Returns: array{content: array<int, array<string, mixed>>, isError: bool} The result of the tool execution.

Exceptions

Exception If the tool is blocked, not found or execution fails.

Definition at line 324 of file mcp_protocol.class.php.

Referenced by handleRequest().

◆ handleToolsList()

MCPServer::handleToolsList ( )

private

Handles the 'tools/list' request by delegating to McpHandler.

Only tools permitted by AI_MCP_SERVER_ALLOWED_TOOLS are returned.

Returns: array{tools: array<int, array<string, mixed>>} An array containing the list of available tools.

Definition at line 305 of file mcp_protocol.class.php.

Referenced by handleRequest().

◆ serverCapabilities()

MCPServer::serverCapabilities ( )

private

Capabilities shared by initialize and server/discover.

The 'logging' capability was dropped (deprecated in spec 2026-07-28 and this server never emitted notifications/message).

Returns: array{tools: array{listChanged: bool}, resources: array{subscribe: bool, listChanged: bool}, prompts: array{listChanged: bool}}

Definition at line 269 of file mcp_protocol.class.php.

Referenced by handleDiscover(), and handleInitialize().

◆ successResponse()

MCPServer::successResponse ( $result )

private

Creates a successful JSON-RPC response.

Parameters

mixed $result The result data to include in the response.

Returns: array{jsonrpc: string, id: int|string, result: mixed}|null The formatted JSON-RPC response, or null for notifications.

Definition at line 509 of file mcp_protocol.class.php.

Referenced by handleRequest().

◆ validateTransportHeaders()

MCPServer::validateTransportHeaders	(	array	$headers,
		array	$request )

Validate the spec 2026-07-28 transport headers against the request body.

Enforcement is presence-based for backward compatibility: a 2025-11-25 client sending no Mcp-* headers is untouched, but any header that IS present must agree with the body (HeaderMismatchError -32020, HTTP 400) and any protocol version named must be one we support (UnsupportedProtocolVersionError -32022, HTTP 400). This is also the enforcement point the Rate Limiting roadmap item keys on: proxies can throttle per-tool on Mcp-Method/Mcp-Name without parsing bodies, because we guarantee here that the headers never lie about the body.

Parameters

array<string,string>	$headers HTTP request headers (any case)
array<string,mixed>	$request Decoded JSON-RPC request body

Returns: array{jsonrpc: string, id: int|string, error: array{code: int, message: string, data?: mixed}}|null Error response to emit, or null when valid

Definition at line 119 of file mcp_protocol.class.php.

References errorResponse().

The documentation for this class was generated from the following file:

dolibarr_dev/htdocs/ai/class/mcp_protocol.class.php

Public Member Functions

Private Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ errorResponse()

◆ getHttpStatus()

◆ handleDiscover()

◆ handleInitialize()

◆ handlePromptGet()

◆ handlePromptsList()

◆ handleRequest()

◆ handleResourceRead()

◆ handleResourcesList()

◆ handleToolCall()

◆ handleToolsList()

◆ serverCapabilities()

◆ successResponse()

◆ validateTransportHeaders()