Package org.machanism.machai.mcp.server

Class HttpStreamableMcpServer

java.lang.Object

org.machanism.machai.mcp.server.AbstractMcpServer

org.machanism.machai.mcp.server.AbstractHttpMcpServer

org.machanism.machai.mcp.server.HttpStreamableMcpServer

public class HttpStreamableMcpServer
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	HttpStreamableMcpServer.HttpStreamableToolSpecificationBuilder	Builds streamable 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.SyncSpecification<io.modelcontextprotocol.server.McpServer.StreamableSyncSpecification>	server	The MCP server specification for stateless sync operation.
private io.modelcontextprotocol.server.transport.HttpServletStreamableServerTransportProvider	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
HttpStreamableMcpServer(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.SyncSpecification<io.modelcontextprotocol.server.McpServer.StreamableSyncSpecification> 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.HttpServletStreamableServerTransportProvider transportProvider

HTTP transport provider for the MCP server.

Constructor Details

HttpStreamableMcpServer

public HttpStreamableMcpServer(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

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