MCP Mediator

MCP Mediator is a Java - based implementation of the Model Context Protocol (MCP) mediator, providing seamless integration between MCP clients and servers, supporting efficient communication and tool execution. The project includes core modules, examples, and various service integrations, supports quickly converting existing code into MCP services through annotations, and has the ability to proxy multiple servers.

Developer tools Artificial intelligence chatbots #Protocol mediator #Tool integration #Java framework #Service proxy .Java

rating : 2.5 points

downloads : 12.4K

update time : 2025-04-28

Open Site

What is an MCP server?

An MCP server is a framework based on the Model Context Protocol (MCP), designed to achieve seamless communication between clients and servers. It supports the integration and execution of multiple tools and provides flexible extensibility.

How to use an MCP server?

By registering request handlers and configuring the server, you can easily create an MCP server instance. Just follow a few simple steps to start processing requests from clients.

Applicable scenarios

MCP servers are suitable for scenarios that require cross - platform collaboration, automated task execution, and complex tool integration, such as developer toolchains and enterprise - level application integration.

Main Features

Support for multiple transmission mechanisms

The MCP server supports multiple communication methods such as standard input/output (stdio) and Server - Sent Events (SSE).

Dynamic tool generation

Automatically generate MCP tools through annotations or configuration files without manually writing a large amount of code.

Multi - server proxy mode

Supports proxying multiple remote MCP servers and centrally managing client requests.

Spring Boot integration

Comes with a built - in Spring Boot Starter module to quickly build Spring - based applications.

Advantages

Easy to expand and customize

Supports a rich plugin system

Efficient request - response mechanism

Limitations

Highly dependent on the Java environment

Some advanced features are still in development

How to Use

Install dependencies

Ensure that Java 17 or a higher version and the Maven tool are installed.

Initialize the MCP server

Start the server using default configuration or a custom configuration file.

Add logic to handle specific requests.

Usage Examples

Search Wikipedia

After the user enters a keyword, the MCP server will call the Wikipedia API to obtain relevant content.

Start a Docker container

Start an existing Docker container by specifying the container ID.

Frequently Asked Questions

Does the MCP server support other programming languages?

How to deploy the MCP server to a production environment?

What open - source components does the MCP server have?

Related Resources

Official documentation

Details the MCP protocol and its server implementation.

GitHub repository

Source code hosting address.

YouTube tutorial

Watch the video to learn how to quickly get started with the MCP server.

🚀 MCP Middleware

The MCP Middleware is a Java-based implementation for mediation integration, supporting the Model Context Protocol (MCP). It serves as a bridge between clients and servers. This protocol is mainly used in the field of artificial intelligence to enhance functionality through tools and services.

✨ Features

Completed Features

Default MCP Middleware: Serves as a basic MCP service, supporting multiple functions.
Proxy MCP Middleware: Allows the creation of proxy servers to connect multiple remote servers and acts as a bridge between clients and these servers.
Tool Extension: Supports function extension by registering handlers.

Ongoing Features

Extending proxy functionality to allow direct connection to remote MCP services and advertise tools.

Planned Features

Implementing a custom MCP connection protocol.
Developing an MCP-based API gateway.

📦 Module Structure

The project is divided into the following Maven modules:

mcp-mediator: Core middleware implementation, including default and proxy servers.
mcp-mediator-api: Defines core interfaces and classes.
mcp-mediator-implementation-query: Provides multiple query tools, such as Wikipedia search, Stack Overflow search, and GitHub project search.

🚀 Quick Start

Prerequisites

JDK 17 or higher
Maven 3.x or higher

💻 Usage Examples

Basic Usage

// For example: ~/sdk/jdk/jdk-17.0.14+7/Contents/Home/bin/java
String command = args[0];
// Such as: -jar ~/mcp-mediator-example.jar
List<String> remoteServerArgs = List.of(Arrays.copyOfRange(args, 1, args.length));

DefaultMcpMediator middleware = new DefaultMcpMediator(McpMediatorConfigurationBuilder.builder()
       .defaultConfig()
       .serializer(new ObjectMapper())
       .tools(true)
       .addRemoteServer(McpMediatorDefaultConfiguration.McpMediatorDefaultServerConfiguration.builder()
               .remoteTransportType(McpTransportType.STDIO)
               .remoteServerAddress(command)
               .remoteServerArgs(remoteServerArgs)
               .build())
       .serverName("MY_EXAMPLE_MCP_SERVER_STDIO")
       .serverVersion("1.0.0.0")
       .build());

middleware.initialize();

Advanced Usage

ProxyMcpMediator proxy = new ProxyMcpMediator(McpMediatorConfigurationBuilder.builder()
       .proxyConfig()
       .serializer(new ObjectMapper())
       .tools(true)
       .addRemoteServer(McpMediatorProxyConfiguration.McpMediatorRemoteMcpServerConfiguration.builder()
               .remoteTransportType(McpTransportType.STDIO)
               .remoteServerAddress(command)
               .remoteServerArgs(remoteServerArgs)
               .build())
       .serverName("MY_EXAMPLE_MCP_SERVER_STDIO")
       .serverVersion("1.0.0.0")
       .build());

proxy.initialize();