Class GenericMCPToolAdapter

java.lang.Object

ai.redouble.nucleo.harness.AbstractJob<MCPToolResult>

ai.redouble.nucleo.tools.AbstractTool<MCPToolInput, MCPToolResult>

ai.redouble.nucleo.mcp.GenericMCPToolAdapter

All Implemented Interfaces:

GuardedExecution, Identifiable, Job<MCPToolResult>, Tool<MCPToolInput, MCPToolResult>

public class GenericMCPToolAdapter
extends AbstractTool<MCPToolInput, MCPToolResult>

Adapts an MCP-served tool to the Nucleo tool framework. Wraps an MCPClient and a specific MCPToolDescriptor, exposing the standard Tool contract so MCP tools participate in thinker tool loops alongside native ones.

The adapter takes a connector MCPHandle so observability metadata (obs.mcp.handle, obs.mcp.tool) and the namespaced LLM-facing identity stay consistent with MCPToolProvider.name().

Since:

0.1 (2026-01-10)

Author:

Andrey Santrosyan

Field Summary

Fields inherited from class AbstractTool

input

Fields inherited from class AbstractJob

timeout, upstreamRetries

Fields inherited from interface Job

DEFAULT_UPSTREAM_RETRIES

Fields inherited from interface Tool

OBS_INPUT, OBS_OUTPUT

Constructor Summary

Constructors

Constructor	Description
GenericMCPToolAdapter(Identifiable parent, MCPClient client, MCPToolDescriptor descriptor, MCPHandle handle)	Creates an adapter for a specific MCP tool.

Method Summary

Modifier and Type	Method	Description
MCPToolResult	execute(JobResources resources, JobContext<MCPToolResult> ctx)	Executes the job with the provided resources and context.
MCPClient	getClient()
MCPToolDescriptor	getDescriptor()
MCPHandle	getHandle()
JobRequirements	getRequirements()	Default requirements for tools.
String	getToolDescription()
String	getToolName()

Methods inherited from class AbstractTool

getInput, getJobType, postExecute, preExecute, setInput

Methods inherited from class AbstractJob

getId, getName, getParentJobId, getPriority, getTimeout, getUpstreamRetries, getUserId, getWorkflowId, randomIdSuffix, setTimeout, setUpstreamRetries, toString

Methods inherited from class Object

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

Methods inherited from interface GuardedExecution

declareAdmissionGuardrails, declareAuthGuardrails, declareContentGuardrails

Methods inherited from interface Identifiable

getParentJobId, getUserId, getWorkflowId

Methods inherited from interface Job

getDisplayName, getId, getJobId, getName, getPriority, getTimeout, getUpstreamRetries

Methods inherited from interface Tool

guardedInputTarget

Constructor Details

GenericMCPToolAdapter

public GenericMCPToolAdapter(Identifiable parent,
 MCPClient client,
 MCPToolDescriptor descriptor,
 MCPHandle handle)

Creates an adapter for a specific MCP tool.

Parameters:

parent - the parent for lineage tracking

client - the MCP client to use for tool calls

descriptor - the descriptor for the specific tool to wrap

handle - the connector handle that owns this tool (required so observability metadata and namespacing line up with the provider)

Method Details

getRequirements

public JobRequirements getRequirements()

Description copied from class: AbstractTool

Default requirements for tools. Subclasses should override to add database, LLM, or other requirements. JobType is handled by AbstractTool.getJobType(), not here.

Specified by:

getRequirements in interface Job<MCPToolResult>

Overrides:

getRequirements in class AbstractTool<MCPToolInput, MCPToolResult>

Returns:

resource requirements, or null if the job needs no resources

execute

public MCPToolResult execute(JobResources resources,
 JobContext<MCPToolResult> ctx)
                      throws LLMReadableCheckedException

Description copied from interface: Job

Executes the job with the provided resources and context. A job reports progress and checks for cancellation through the context, and completes all its work before returning. A tool narrows this contract to the LLM-readable exceptions of Tool.execute(JobResources, JobContext).

Parameters:

resources - the allocated resources

ctx - the job execution context for monitoring

Returns:

the job result, which may be null

Throws:

LLMReadableCheckedException - if execution fails

getDescriptor

public MCPToolDescriptor getDescriptor()

getToolName

public String getToolName()

getToolDescription

public String getToolDescription()

getClient

public MCPClient getClient()

getHandle

public MCPHandle getHandle()