Package org.machanism.machai.mcp.server

Class StdioMcpServer

java.lang.Object

org.machanism.machai.mcp.server.AbstractMcpServer

org.machanism.machai.mcp.server.StdioMcpServer

public class StdioMcpServer
extends AbstractMcpServer

StdioMcpServer sets up and runs a Model Context Protocol (MCP) server that communicates via standard input and output (STDIO).

This server loads GenAI tools, configures server capabilities, and exposes the MCP API over STDIO for integration with other processes.

Since:

1.2.0

Author:

Viktor Tovstyi

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
(package private) class	StdioMcpServer.StdioToolSpecificationBuilder

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.SingleSessionSyncSpecification>	server	The MCP server specification for single-session sync operation.

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

MACHAI_MACHANISM_HOMEPAGE, MACHAI_MACHANISM_ICON

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method	Description
(package private) void	start()	Builds and returns the configured McpSyncServer instance.
(package private) void	tools(Configurator config)	Loads and registers GenAI tools with the MCP server.

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.SingleSessionSyncSpecification> server

The MCP server specification for single-session sync operation.

functionToolsLoader

private FunctionToolsLoader functionToolsLoader

Loader for registering function-based tools.

Constructor Details

StdioMcpServer

StdioMcpServer(String name,
 String version)

Constructs a new StdioMcpServer 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

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

void start()

Builds and returns the configured McpSyncServer instance.

Also registers a shutdown hook to ensure the server is closed gracefully on JVM exit.

Specified by:

start in class AbstractMcpServer