MCP Mediator

MCP Mediator是一個基於Java的模型上下文協議(MCP)中介實現，提供MCP客戶端與服務器間的無縫集成，支持高效通信和工具執行。項目包含核心模塊、示例及多種服務集成，支持通過註解快速將現有代碼轉為MCP服務，並具備代理多服務器能力。

開發者工具人工智能聊天機器人 #協議中介 #工具集成 #Java框架 #服務代理 .Java

評分 : 2.5分

下載量 : 149

更新時間 : 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 項目搜索。