Package eu.mrapik.minecraftservermcp.internal

Class MinecraftServerMcpImpl

java.lang.Object

eu.mrapik.minecraftservermcp.internal.MinecraftServerMcpImpl

All Implemented Interfaces:

MinecraftServerMcp

public final class MinecraftServerMcpImpl
extends Object
implements MinecraftServerMcp

Service implementation registered under MinecraftServerMcp: tools are added through ToolInvocationGate, while built-in resources are registered separately in McpHttpServer using ResourceInvocationGate.

Reloading configuration updates PluginSettings for subsequent invocations; it does not unregister tools or resources.

Constructor Summary

Constructors

Constructor	Description
MinecraftServerMcpImpl(JavaPlugin mcpPlugin, AtomicReference<PluginSettings> settingsRef, ServerFilePaths paths, io.modelcontextprotocol.server.McpAsyncServer mcpServer)	Creates the service implementation registered under MinecraftServerMcp.

Method Summary

Modifier and Type	Method	Description
@NotNull io.modelcontextprotocol.server.McpAsyncServer	mcpServer()	Direct access to the underlying Model Context Protocol async server.
@NotNull reactor.core.publisher.Mono<Void>	registerTool(@NotNull McpToolDefinition definition)	Adds a tool to the MCP server, or replaces an existing tool with the same MCP tool name.
void	reloadConfiguration()	Reloads this plugin's config.yml from disk and replaces the in-memory PluginSettings.
@Nullable String	toolOwningPlugin(@NotNull String toolId)	Returns which Bukkit plugin registered the given MCP tool name, for ownership checks in MinecraftServerMcp.unregisterToolAs(java.lang.String, org.bukkit.plugin.Plugin).
@NotNull reactor.core.publisher.Mono<Void>	unregisterTool(@NotNull String toolId)	Removes a tool from the MCP server by its advertised MCP name.
@NotNull reactor.core.publisher.Mono<Void>	unregisterToolAs(@NotNull String toolId, @NotNull Plugin caller)	Removes a tool only if caller's name matches the plugin that registered it (see MinecraftServerMcp.toolOwningPlugin(String)).

Methods inherited from class java.lang.Object

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

Constructor Details

MinecraftServerMcpImpl

public MinecraftServerMcpImpl(JavaPlugin mcpPlugin,
 AtomicReference<PluginSettings> settingsRef,
 ServerFilePaths paths,
 io.modelcontextprotocol.server.McpAsyncServer mcpServer)

Creates the service implementation registered under MinecraftServerMcp.

Parameters:

mcpPlugin - plugin instance that owns logging and service registration

settingsRef - atomic holder of PluginSettings, updated when configuration reloads

paths - resolved server directory for tool invocations that need filesystem context

mcpServer - MCP async server instance tools are registered against

Method Details

registerTool

@NotNull
public @NotNull reactor.core.publisher.Mono<Void> registerTool(@NotNull
 @NotNull McpToolDefinition definition)

Description copied from interface: MinecraftServerMcp

Adds a tool to the MCP server, or replaces an existing tool with the same MCP tool name.

The definition's McpToolDefinition.id() must equal McpSchema.Tool.name(). Configuration for that tool is read from access.<profile>.tools.<id> for each token profile.

Specified by:

registerTool in interface MinecraftServerMcp

Parameters:

definition - tool metadata and handler; not null

Returns:

completes when the tool is visible to MCP clients (may notify list changes)

unregisterTool

@NotNull
public @NotNull reactor.core.publisher.Mono<Void> unregisterTool(@NotNull
 @NotNull String toolId)

Description copied from interface: MinecraftServerMcp

Removes a tool from the MCP server by its advertised MCP name.

This is unconditional (operator/trusted caller). Plugins that registered a tool should prefer MinecraftServerMcp.unregisterToolAs(String, Plugin) so only the owning plugin can remove it.

Specified by:

unregisterTool in interface MinecraftServerMcp

Parameters:

toolId - same string as McpToolDefinition.id() / McpSchema.Tool.name()

Returns:

completes when the tool has been removed

unregisterToolAs

@NotNull
public @NotNull reactor.core.publisher.Mono<Void> unregisterToolAs(@NotNull
 @NotNull String toolId,
 @NotNull
 @NotNull Plugin caller)

Description copied from interface: MinecraftServerMcp

Removes a tool only if caller's name matches the plugin that registered it (see MinecraftServerMcp.toolOwningPlugin(String)).

Specified by:

unregisterToolAs in interface MinecraftServerMcp

Parameters:

toolId - MCP tool name

caller - plugin that must own the tool

Returns:

completes when removed, or errors if the tool is unknown or not owned by caller

toolOwningPlugin

@Nullable
public @Nullable String toolOwningPlugin(@NotNull
 @NotNull String toolId)

Description copied from interface: MinecraftServerMcp

Returns which Bukkit plugin registered the given MCP tool name, for ownership checks in MinecraftServerMcp.unregisterToolAs(java.lang.String, org.bukkit.plugin.Plugin).

Specified by:

toolOwningPlugin in interface MinecraftServerMcp

Parameters:

toolId - MCP tool name (same as McpToolDefinition.id())

Returns:

the registering plugin's name, or null if no such tool is registered

reloadConfiguration

public void reloadConfiguration()

Description copied from interface: MinecraftServerMcp

Reloads this plugin's config.yml from disk and replaces the in-memory PluginSettings. Already-registered tools stay registered; subsequent tool invocations use the new token and policy values.

Specified by:

reloadConfiguration in interface MinecraftServerMcp

mcpServer

@NotNull
public @NotNull io.modelcontextprotocol.server.McpAsyncServer mcpServer()

Description copied from interface: MinecraftServerMcp

Direct access to the underlying Model Context Protocol async server.

Use this for advanced integration (sessions, capabilities) if you need more than MinecraftServerMcp.registerTool(eu.mrapik.minecraftservermcp.api.McpToolDefinition). Typical plugin code only needs MinecraftServerMcp.registerTool(eu.mrapik.minecraftservermcp.api.McpToolDefinition) and MinecraftServerMcp.unregisterTool(java.lang.String).

Specified by:

mcpServer in interface MinecraftServerMcp

Returns:

the non-null MCP server instance used by this plugin