MCP Mediator

🚀 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 模塊：

1. mcp-mediator：核心中間件實現，包括默認和代理服務器。
2. mcp-mediator-api：定義了核心接口和類。
3. mcp-mediator-implementation-query：提供多個查詢工具，如維基百科搜索、Stack Overflow 搜索和 GitHub 項目搜索。

📚 詳細文檔

已實現的查詢 MCP 服務器

• Wikipedia MCP 服務器：根據輸入查詢搜索維基百科內容。
• Stack Overflow MCP 服務器：搜索 Stack Overflow 網站。
• GitHub MCP 服務器：根據查詢搜索 GitHub 項目。

🤝 貢獻指南

歡迎貢獻！請參考 CONTRIBUTING.md 文件瞭解如何參與。

📄 許可證

本項目使用 GPL3.0 許可證，詳情請見 LICENSE。