Package eu.mrapik.minecraftservermcp.internal

Class ResourceInvocationGate

java.lang.Object

eu.mrapik.minecraftservermcp.internal.ResourceInvocationGate

public final class ResourceInvocationGate
extends Object

Applies the same bearer-token and ToolAccessConfig checks as ToolInvocationGate, but for MCP resources/read requests. The policyToolId argument is the key under access.<profile>.tools (for example fs_read).

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	ResourceInvocationGate.ResourceHandler	Callback executed after ResourceInvocationGate has resolved the token profile and confirmed that the policy id is enabled.

Method Summary

Modifier and Type	Method	Description
static io.modelcontextprotocol.server.McpServerFeatures.AsyncResourceSpecification	wrapResource(String policyToolId, io.modelcontextprotocol.spec.McpSchema.Resource resource, Supplier<PluginSettings> settings, JavaPlugin mcpPlugin, ServerFilePaths paths, ResourceInvocationGate.ResourceHandler inner)	Builds an McpServerFeatures.AsyncResourceSpecification whose read handler validates the transport token and profile before invoking the delegate.
static io.modelcontextprotocol.server.McpServerFeatures.AsyncResourceTemplateSpecification	wrapTemplate(String policyToolId, io.modelcontextprotocol.spec.McpSchema.ResourceTemplate template, Supplier<PluginSettings> settings, JavaPlugin mcpPlugin, ServerFilePaths paths, ResourceInvocationGate.ResourceHandler inner)	Builds an McpServerFeatures.AsyncResourceTemplateSpecification for a URI template, with the same access checks as wrapResource(java.lang.String, io.modelcontextprotocol.spec.McpSchema.Resource, java.util.function.Supplier<eu.mrapik.minecraftservermcp.config.PluginSettings>, org.bukkit.plugin.java.JavaPlugin, eu.mrapik.minecraftservermcp.fs.ServerFilePaths, eu.mrapik.minecraftservermcp.internal.ResourceInvocationGate.ResourceHandler).

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details

wrapResource

public static io.modelcontextprotocol.server.McpServerFeatures.AsyncResourceSpecification wrapResource(String policyToolId,
 io.modelcontextprotocol.spec.McpSchema.Resource resource,
 Supplier<PluginSettings> settings,
 JavaPlugin mcpPlugin,
 ServerFilePaths paths,
 ResourceInvocationGate.ResourceHandler inner)

Builds an McpServerFeatures.AsyncResourceSpecification whose read handler validates the transport token and profile before invoking the delegate.

Parameters:

policyToolId - config key under access.<profile>.tools.* used to load ToolAccessConfig

resource - static resource metadata (URI, name, mime type) for McpAsyncServer.addResource(io.modelcontextprotocol.server.McpServerFeatures.AsyncResourceSpecification)

settings - supplier for current PluginSettings (token profiles)

mcpPlugin - owning MCP plugin instance

paths - server root paths for handlers that need them

inner - handler run only when the profile enables policyToolId

Returns:

specification suitable for McpAsyncServer.addResource(io.modelcontextprotocol.server.McpServerFeatures.AsyncResourceSpecification)

wrapTemplate

public static io.modelcontextprotocol.server.McpServerFeatures.AsyncResourceTemplateSpecification wrapTemplate(String policyToolId,
 io.modelcontextprotocol.spec.McpSchema.ResourceTemplate template,
 Supplier<PluginSettings> settings,
 JavaPlugin mcpPlugin,
 ServerFilePaths paths,
 ResourceInvocationGate.ResourceHandler inner)

Builds an McpServerFeatures.AsyncResourceTemplateSpecification for a URI template, with the same access checks as wrapResource(java.lang.String, io.modelcontextprotocol.spec.McpSchema.Resource, java.util.function.Supplier<eu.mrapik.minecraftservermcp.config.PluginSettings>, org.bukkit.plugin.java.JavaPlugin, eu.mrapik.minecraftservermcp.fs.ServerFilePaths, eu.mrapik.minecraftservermcp.internal.ResourceInvocationGate.ResourceHandler).

Parameters:

policyToolId - config key under access.<profile>.tools.*

template - resource template (RFC 6570 URI template string) for McpAsyncServer.addResourceTemplate(io.modelcontextprotocol.server.McpServerFeatures.AsyncResourceTemplateSpecification)

settings - supplier for current PluginSettings

mcpPlugin - owning MCP plugin instance

paths - server root paths for handlers that need them

inner - handler run only when the profile enables policyToolId

Returns:

specification suitable for McpAsyncServer.addResourceTemplate(io.modelcontextprotocol.server.McpServerFeatures.AsyncResourceTemplateSpecification)