Package org.apache.juneau.rest.server.mcp

package org.apache.juneau.rest.server.mcp

Revision-neutral core for MCP endpoints built on juneau-rest-server.

This package knows the shape of an MCP server — tools, prompts, resources, pagination, the JSON-RPC dispatch contract, and the two HTTP entry points — without knowing any MCP protocol revision. It has no compile dependency on any revision's wire beans, and that is enforced at build time. A protocol revision is supplied by an implementation of McpRevision living in its own module (for example juneau-rest-server-mcp-v20250618), and a consumer binds one at compile time by extending that revision's abstract servlet or composing its endpoint mixin.

See Also:

• juneau-rest-server-mcp

Related Packages

Package	Description
org.apache.juneau.rest.server	REST Server API
org.apache.juneau.rest.server.mcp.v20250618	MCP 2025-06-18 binding for juneau-rest-server-mcp.
org.apache.juneau.rest.server.mcp.v20260728	MCP 2026-07-28 binding for juneau-rest-server-mcp.

Class	Description
AbstractMcpRestServlet	Drop-in BasicRestServlet subclass that exposes a single MCP JSON-RPC endpoint at POST /.
BasicMcpSubscriptionBroker	Default McpSubscriptionBroker: a ConcurrentHashMap-backed registry doing filtered fan-out.
McpChangeEvent	A single revision-neutral change event published through McpSubscriptions and fanned out by an McpSubscriptionBroker to every matching McpSubscription.
McpChangeKind	The kind of change a neutral MCP subscription can be notified about.
McpCompleter	Application behavior invoked for a completion/complete request against a declared prompt argument (McpPromptArgument.getCompleter()) or resource-template variable (McpResourceTemplateHandler.completer(String)).
McpCompletionRef	Revision-neutral identification of the declaration a completion/complete request targets.
McpCompletionRef.Kind	The kind of declaration a McpCompletionRef targets.
McpCompletionRequest	Revision-neutral invocation of an McpCompleter.
McpCompletionResult	Revision-neutral, as-returned-by-the-application result of an McpCompleter invocation.
McpCompletionResult.Normalized	The normalized shape of a completion result, ready for wire mapping.
McpContentBlock	Revision-neutral content block returned by tool calls and prompt messages.
McpContentBlock.Kind	Which content variant is populated.
McpCursor	Pagination strategy for MCP list dispatchers (tools / prompts / resources / resource templates).
McpDispatchResult	The non-notification result of one McpRevision.dispatch(McpExchange, McpServerConfig, org.apache.juneau.commons.inject.BeanStore) call: either a complete JSON-RPC response envelope (McpResponseResult) or a held-open streaming publisher (McpStreamResult, for a revision-specific method whose successful result is not a single JSON-RPC envelope, e.g. the 2026-07-28 subscriptions/listen method).
McpEndpointMixin	Mixin interface that exposes an MCP JSON-RPC endpoint at POST /mcp on any Juneau REST resource.
McpErrorKind	Revision-neutral classification of a dispatch failure.
McpExchange	The inbound JSON-RPC envelope plus request-header access, with no servlet or HTTP types attached.
McpPage<T>	Slice of MCP descriptors returned by McpCursor.page(List, String, org.apache.juneau.commons.inject.BeanStore).
McpParamUtils	Shared internal plumbing for revision McpRevision.dispatch(org.apache.juneau.rest.server.mcp.McpExchange, org.apache.juneau.rest.server.mcp.McpServerConfig, org.apache.juneau.commons.inject.BeanStore) implementations.
McpPromptArgument	Revision-neutral declared argument of a prompt.
McpPromptHandler	Handler for a single MCP prompt.
McpPromptMessage	Revision-neutral single message within a prompt result.
McpPromptOutcome	Revision-neutral result of a prompts/get invocation.
McpPromptSpec	Revision-neutral prompt descriptor returned from prompts/list.
McpResourceContents	Revision-neutral resource payload, either inline text or a base64 blob.
McpResourceContents.Kind	Which payload variant is populated.
McpResourceHandler	Handler for a single MCP resource.
McpResourceOutcome	Revision-neutral result of a resources/read invocation.
McpResourceSpec	Revision-neutral resource descriptor returned from resources/list.
McpResourceTemplateHandler	Handler for a single MCP resource template.
McpResourceTemplateHandler.ReadFunction	A three-argument function from (uri, variables, ctx) to a McpResourceOutcome, matching McpResourceTemplateHandler.ReadFunction.read(String, Map, BeanStore)'s signature.
McpResourceTemplateSpec	Revision-neutral resource-template descriptor returned from resources/templates/list.
McpResponseResult	A McpDispatchResult wrapping a complete JSON-RPC response envelope — the common (non-streaming) McpRevision.dispatch(org.apache.juneau.rest.server.mcp.McpExchange, org.apache.juneau.rest.server.mcp.McpServerConfig, org.apache.juneau.commons.inject.BeanStore) outcome.
McpRevision	Service-provider interface implemented once per MCP protocol revision.
McpRole	Revision-neutral role for McpPromptMessage entries.
McpSchema	Revision-neutral carrier for a tool's input schema.
McpServerConfig	Aggregate configuration consumed by the bound McpRevision.
McpServerConfig.ResourceTemplateMatch	The result of McpServerConfig.resolveResourceTemplate(String): the winning resource-template handler paired with the variables decoded from the concrete request URI.
McpStreamResult	A McpDispatchResult wrapping a held-open streaming publisher, for a revision-specific method whose successful result is not a single JSON-RPC envelope (for example the 2026-07-28 subscriptions/listen method).
McpSubscription	Per-subscription queue handle minted by an McpSubscriptionBroker.
McpSubscriptionBroker	Revision-neutral registry + filtered fan-out publisher for MCP subscriptions/listen.
McpSubscriptionFilter	A revision-neutral, immutable subscription filter: the set of change kinds and resource URIs one McpSubscription is interested in.
McpSubscriptions	App-facing, revision-neutral change-publish SPI for MCP subscriptions/listen.
McpToolHandler	Handler for a single MCP tool.
McpToolOutcome	Revision-neutral result of a tools/call invocation.
McpToolSpec	Revision-neutral tool descriptor returned from tools/list.
McpTypedHandlers	Bridges typed tool handlers into raw McpToolHandlers.
McpTypedToolHandler<A,R>	Strongly-typed tool handler whose argument and result Java types drive schema derivation and binding.
McpUriTemplateMatcher	Hand-rolled, dependency-free compiler and reverse matcher for the narrow, reliably-invertible subset of RFC 6570 URI templates used by MCP resource-template reads.