MCP Mediator

MCP Mediator是一个基于Java的模型上下文协议(MCP)中介实现，提供MCP客户端与服务器间的无缝集成，支持高效通信和工具执行。项目包含核心模块、示例及多种服务集成，支持通过注解快速将现有代码转为MCP服务，并具备代理多服务器能力。

开发者工具人工智能聊天机器人 #协议中介 #工具集成 #Java框架 #服务代理 .Java

评分 : 2.5分

下载量 : 32.1K

更新时间 : 2025-04-28

打开站点

什么是MCP服务器？

MCP服务器是一种基于Model Context Protocol (MCP) 的框架，旨在实现客户端和服务端之间的无缝通信。它支持多种工具的集成与执行，并提供了灵活的扩展能力。

如何使用MCP服务器？

通过注册请求处理器和配置服务器，您可以轻松创建一个MCP服务器实例。只需几个简单的步骤，即可开始处理来自客户端的请求。

适用场景

MCP服务器适用于需要跨平台协作、自动化任务执行以及复杂工具集成的场景，例如开发者工具链、企业级应用集成等。

主要功能

支持多种传输机制

MCP服务器支持标准输入输出（stdio）和服务器发送事件（SSE）等多种通信方式。

动态工具生成

通过注解或配置文件自动生成MCP工具，无需手动编写大量代码。

多服务器代理模式

支持代理多个远程MCP服务器，统一管理客户端请求。

Spring Boot 集成

内置Spring Boot Starter模块，快速构建基于Spring的应用程序。

优势

易于扩展和定制化

支持丰富的插件系统

高效的请求响应机制

局限性

对Java环境依赖较高

某些高级特性仍处于开发阶段

如何使用

安装依赖

确保已安装Java 17及以上版本及Maven工具。

初始化MCP服务器

使用默认配置或自定义配置文件启动服务器。

注册请求处理器

添加处理特定请求的逻辑。

使用案例

搜索维基百科

用户输入关键词后，MCP服务器会调用维基百科API获取相关内容。

启动Docker容器

通过指定容器ID启动已存在的Docker容器。

常见问题

MCP服务器是否支持其他编程语言？

如何部署MCP服务器到生产环境？

MCP服务器有哪些开源组件？

🚀 MCP 中间件

MCP 中间件是基于 Java 实现的中介集成工具，支持 Model Context Protocol (MCP) 协议，可连接客户端与服务器。该协议主要应用于人工智能领域，借助工具和服务增强功能。

🚀 快速开始

先决条件

JDK 17 或更高版本
Maven 3.x 或更高版本

示例代码

创建默认 MCP 中间件

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

DefaultMcpMediator 中间件 = 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());

中间件.initialize();

创建代理 MCP 中间件

ProxyMcpMediator 代理 = 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());

代理.initialize();

✨ 主要特性

已完成的功能

默认 MCP 中间件：作为基础的 MCP 服务，支持多种功能。
代理 MCP 中间件：允许创建代理服务器，连接多个远程服务器，充当客户端与这些服务器之间的桥梁。
工具扩展：支持通过注册处理程序来扩展功能。

正在进行的功能

扩展代理功能，允许直接连接到远程 MCP 服务，并 advertise 工具。

计划中的功能

实现自定义的 MCP 连接协议。
开发基于 MCP 的 API 网关。

📚 详细文档

模块结构

项目分为以下几个 Maven 模块：

mcp-mediator：核心中间件实现，包括默认和代理服务器。
mcp-mediator-api：定义了核心接口和类。
mcp-mediator-implementation-query：提供多个查询工具，如维基百科搜索、Stack Overflow 搜索和 GitHub 项目搜索。