Package org.machanism.machai.mcp.server

Class HttpStatelessMcpServer

java.lang.Object

org.machanism.machai.mcp.server.AbstractMcpServer

org.machanism.machai.mcp.server.AbstractHttpMcpServer

org.machanism.machai.mcp.server.HttpStatelessMcpServer

public class HttpStatelessMcpServer
extends AbstractHttpMcpServer

HttpStatelessMcpServer sets up and runs a Model Context Protocol (MCP) server that listens for HTTP requests on a specified port.

This server loads GenAI tools, configures server capabilities, and exposes the MCP API over HTTP using Jetty.

Since:

1.2.0

Author:

Viktor Tovstyi

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
class	HttpStatelessMcpServer.HttpStatelessToolSpecificationBuilder	Builds stateless MCP tool specifications from generic tool definitions.

Nested classes/interfaces inherited from class org.machanism.machai.mcp.server.AbstractMcpServer

AbstractMcpServer.ToolSpecificationBuilder<TExchange>

Field Summary

Fields

Modifier and Type	Field	Description
private FunctionToolsLoader	functionToolsLoader	Loader for registering function-based tools.
private final org.slf4j.Logger	log
private final io.modelcontextprotocol.server.McpServer.StatelessSyncSpecification	server	The MCP server specification for stateless sync operation.
private io.modelcontextprotocol.server.transport.HttpServletStatelessServerTransport	transportProvider	HTTP transport provider for the MCP server.

Fields inherited from class org.machanism.machai.mcp.server.AbstractMcpServer

MACHAI_MACHANISM_HOMEPAGE, MACHAI_MACHANISM_ICON

Constructor Summary

Constructors

Constructor	Description
HttpStatelessMcpServer(String name, String version)	Constructs a new HttpStatelessMcpServer with the given name and version.

Method Summary

Modifier and Type	Method	Description
void	start()	Starts the HTTP server and listens for incoming MCP requests on the specified port.
void	tools(Configurator config)	Loads and registers GenAI tools with the MCP server.

Methods inherited from class org.machanism.machai.mcp.server.AbstractHttpMcpServer

getPort, getTransportProvider, setPort, setTransportProvider

Methods inherited from class org.machanism.machai.mcp.server.AbstractMcpServer

getProjectDir, setProjectDir

Methods inherited from class java.lang.Object

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

Field Details

log

private final org.slf4j.Logger log

server

private final io.modelcontextprotocol.server.McpServer.StatelessSyncSpecification server

The MCP server specification for stateless sync operation.

functionToolsLoader

private FunctionToolsLoader functionToolsLoader

Loader for registering function-based tools.

transportProvider

private io.modelcontextprotocol.server.transport.HttpServletStatelessServerTransport transportProvider

HTTP transport provider for the MCP server.

Constructor Details

HttpStatelessMcpServer

public HttpStatelessMcpServer(String name,
 String version)

Constructs a new HttpStatelessMcpServer with the given name and version.

Parameters:

name - the server name to report in the MCP API

version - the server version to report in the MCP API

Method Details

tools

public void tools(Configurator config)

Loads and registers GenAI tools with the MCP server.

This method uses a FunctionToolsLoader to apply tools to the server using a GenericGenaiAdapter.

Specified by:

tools in class AbstractMcpServer

Parameters:

config - configuration source for tool loading and execution

start

public void start()
           throws Exception

Starts the HTTP server and listens for incoming MCP requests on the specified port.

Overrides:

start in class AbstractHttpMcpServer

Throws:

Exception - if the server fails to start