MCP Mediator

🚀 MCP ミドルウェア

MCP ミドルウェアは、Java をベースに実装された、Model Context Protocol (MCP) プロトコルをサポートする中介集積用のミドルウェアです。このプロトコルは主に人工知能分野で、ツールやサービスを通じて機能を強化するために使用され、クライアントとサーバーを接続します。

✨ 主な機能

実装済みの機能

• デフォルト MCP ミドルウェア：基本的な MCP サービスとして、様々な機能をサポートします。
• プロキシ MCP ミドルウェア：プロキシサーバーを作成し、複数のリモートサーバーに接続し、クライアントとこれらのサーバー間の橋渡しを行います。
• ツール拡張：ハンドラーの登録による機能拡張をサポートします。

開発中の機能

• プロキシ機能を拡張し、リモート MCP サービスに直接接続し、ツールを advertise できるようにする予定です。

計画中の機能

• カスタム MCP 接続プロトコルの実装。
• MCP ベースの API ゲートウェイの開発。

📦 モジュール構成

このプロジェクトは以下の Maven モジュールに分かれています：

1. mcp - mediator：デフォルトおよびプロキシサーバーを含む、核心的なミドルウェアの実装。
2. mcp - mediator - api：核心的なインターフェースとクラスを定義します。
3. mcp - mediator - implementation - query：ウィキペディア検索、Stack Overflow 検索、GitHub プロジェクト検索など、複数のクエリツールを提供します。

🚀 クイックスタート

前提条件

• 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 サーバー

以下は実装済みのクエリツールです：

• Wikipedia MCP サーバー：入力されたクエリに基づいてウィキペディアの内容を検索します。
• Stack Overflow MCP サーバー：Stack Overflow サイトを検索します。
• GitHub MCP サーバー：クエリに基づいて GitHub プロジェクトを検索します。

🤝 コントリビューションガイド

コントリビューションを歓迎します！詳細は CONTRIBUTING.md ファイルを参照してください。

📄 ライセンス

このプロジェクトは GPL3.0 ライセンスの下で公開されています。詳細は LICENSE を参照してください。