Class MCPResources

java.lang.Object

com.erudika.para.server.mcp.MCPResources

@Component
public class MCPResources
extends Object

Para MCP server resources that expose Para data over the Model Context Protocol. All resources require an authenticated App obtained via SecurityUtils.getPrincipalApp().

Constructor Summary

Constructors

Constructor	Description
MCPResources(MCPUtils utils)	Default constructor.

Method Summary

Modifier and Type	Method	Description
io.modelcontextprotocol.spec.McpSchema.ReadResourceResult	readMetadata()	Returns the latest health status and metadata for this Para server.
io.modelcontextprotocol.spec.McpSchema.ReadResourceResult	readRoot()	Returns the root index of available MCP resources and tools.
io.modelcontextprotocol.spec.McpSchema.ReadResourceResult	renderConfigDocumentation()	Returns the configuration documentation in Markdown format.

Methods inherited from class Object

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

Constructor Details

MCPResources

public MCPResources(MCPUtils utils)

Default constructor.

Parameters:

utils - MCP utils

Method Details

readRoot

@McpResource(uri="para:///",
             name="root",
             title="Para MCP Server Index",
             description="Root resource listing available Para MCP resources and tools.",
             mimeType="application/json")
public io.modelcontextprotocol.spec.McpSchema.ReadResourceResult readRoot()

Returns the root index of available MCP resources and tools.

Returns:

the root resource result

readMetadata

@McpResource(uri="para:///metadata",
             name="metadata",
             title="Para Server Information, Health and Metadata",
             description="Returns the latest health status and metadata for this Para server.",
             mimeType="application/json")
public io.modelcontextprotocol.spec.McpSchema.ReadResourceResult readMetadata()

Returns the latest health status and metadata for this Para server.

Returns:

the health resource result

renderConfigDocumentation

@McpResource(uri="para:///config",
             name="config-docs",
             title="Para Configuration Reference",
             description="Browse the complete Para configuration reference with all available settings, descriptions, and default values. Use this to explore what's configurable before using specific tools.",
             mimeType="text/markdown")
public io.modelcontextprotocol.spec.McpSchema.ReadResourceResult renderConfigDocumentation()

Returns the configuration documentation in Markdown format.

Returns:

the config documentation resource result