Struct ThingsMcpServer 

pub struct ThingsMcpServer {
    pub db: Arc<ThingsDatabase>,
    /* private fields */
}

MCP server for Things 3 integration

Fields

db: Arc<ThingsDatabase>

Implementations

impl ThingsMcpServer

pub fn new(db: Arc<ThingsDatabase>, config: ThingsConfig) -> Self

pub fn with_middleware_config( db: ThingsDatabase, config: ThingsConfig, middleware_config: MiddlewareConfig, ) -> Self

Create a new MCP server with custom middleware configuration

pub fn new_with_mcp_config( db: Arc<ThingsDatabase>, config: ThingsConfig, mcp_config: McpServerConfig, ) -> Self

Create a new MCP server with comprehensive configuration

pub fn middleware_chain(&self) -> &MiddlewareChain

Get the middleware chain for inspection or modification

pub fn list_tools(&self) -> McpResult<ListToolsResult>

List available MCP tools

Errors

Returns an error if tool generation fails

pub async fn call_tool( &self, request: CallToolRequest, ) -> McpResult<CallToolResult>

Call a specific MCP tool

Errors

Returns an error if tool execution fails or tool is not found

pub async fn call_tool_with_fallback( &self, request: CallToolRequest, ) -> CallToolResult

Call a specific MCP tool with fallback error handling

This method provides backward compatibility by converting McpError to CallToolResult for cases where the caller expects a CallToolResult even on error

pub fn list_resources(&self) -> McpResult<ListResourcesResult>

List available MCP resources

Errors

Returns an error if resource generation fails

pub async fn read_resource( &self, request: ReadResourceRequest, ) -> McpResult<ReadResourceResult>

Read a specific MCP resource

Errors

Returns an error if resource reading fails or resource is not found

pub async fn read_resource_with_fallback( &self, request: ReadResourceRequest, ) -> ReadResourceResult

Read a specific MCP resource with fallback error handling

This method provides backward compatibility by converting McpError to ReadResourceResult for cases where the caller expects a ReadResourceResult even on error

pub fn list_prompts(&self) -> McpResult<ListPromptsResult>

List available MCP prompts

Errors

Returns an error if prompt generation fails

pub async fn get_prompt( &self, request: GetPromptRequest, ) -> McpResult<GetPromptResult>

Get a specific MCP prompt with arguments

Errors

Returns an error if prompt retrieval fails or prompt is not found

pub async fn get_prompt_with_fallback( &self, request: GetPromptRequest, ) -> GetPromptResult

Get a specific MCP prompt with fallback error handling

This method provides backward compatibility by converting McpError to GetPromptResult for cases where the caller expects a GetPromptResult even on error

pub async fn handle_jsonrpc_request( &self, request: Value, ) -> Result<Option<Value>>

Handle a JSON-RPC request and return a JSON-RPC response

Returns None for notifications (messages without id field) - these don’t require a response

Errors

Returns an error if request parsing or handling fails