MCP Server Maven Plugin

The MCP Server Maven Plugin integrates a Machai Model Context Protocol (MCP) server into a Maven build through aggregator goals for stateless and streamable HTTP transports. It uses the current project's name, version, and base directory, loads the configured PropertiesConfigurator, applies Maven parameters without overriding existing system properties, registers the configured Machai AI tools, and starts the selected server.

The plugin exposes those tools to MCP clients without a separate launcher, supporting local development, repeatable integration tests, demonstrations, and build-driven automation. Both goals are aggregators, so a multi-module reactor starts one server for the reactor rather than one server per module. The MCP Server Maven Plugin supports all types of project files, including source code, documentation, project site content, and other relevant files exposed through its configured tools.

Architecture

The org.machanism.machai.mcp.maven package provides Maven plugin Mojos and utilities for managing MCP server lifecycle and configuration. Its abstract and concrete Mojos share configuration logic for environment variables and credentials. The AbstractMCPServerMojo is the base class for the concrete server Mojos, HttpStatelessServerMojo starts a stateless MCP server, and HttpStreamableMcpServerMojo starts a streamable MCP server.

The org.machanism.machai.mcp.maven.tools package provides function tools and supporting classes for controlling and managing MCP server lifecycle behavior during Maven build execution. Its MCPServerTools utility supports MCP server control, including the stop_mcp_server lifecycle operation.

During execution, the selected Mojo loads the configured server, applies the Maven project context and configuration, registers the configured tools, and starts the selected HTTP transport. MCP clients can then use those tools and request controlled server shutdown.

Packages