MCP Server Howto

🚀 MCP プロトコル Java SDK 完全ガイド

MCP（Model Context Protocol）プロトコルは、モデルコンテキストの接続と管理に使用されるオープン標準で、人工知能や分散システムの開発に広く利用されています。このガイドでは、MCP プロトコルの Java SDK を使用した開発方法を詳しく説明します。

🚀 クイックスタート

SDKのダウンロード

MCP公式サイトにアクセスし、あなたのプロジェクトに適したMCP Java SDKのバージョンをダウンロードしてください。

環境設定

1. 依存関係の追加
   プロジェクトのビルドファイル（pom.xmlやbuild.gradleなど）にMCP SDKの依存関係を追加します。

   <dependency>
       <groupId>io.modelcontextprotocol</groupId>
       <artifactId>mcp-java-sdk</artifactId>
       <version>${mcp.sdk.version}</version>
   </dependency>
   

2. 環境変数の設定
   JDKとMCP SDKが正しくインストールされていることを確認し、MCPツールをシステムパスに追加してください。

💻 使用例

基本的な使用法

クライアントの作成

McpClientファクトリを使用してMCPクライアントを作成します。

import io.modelcontextprotocol.client.McpClient;

public class McpExample {
    public static void main(String[] args) {
        // 创建默认的 MCP 客户端实例
        try (var client = McpClient.createDefault()) {
            // 使用客户端进行操作
            System.out.println("MCP 客户端已创建");
        }
    }
}

サーバーの作成

McpServerファクトリを使用してMCPサーバーを作成します。

import io.modelcontextprotocol.server.McpServer;

public class McpExample {
    public static void main(String[] args) {
        // 创建默认的 MCP 服务器实例
        try (var server = McpServer.createDefault()) {
            // 使用服务器进行操作
            System.out.println("MCP 服务器已创建");
        }
    }
}

高度な使用法

クライアントとサーバーの基本概念

• クライアント：リクエストを送信し、レスポンスを受信します。
• サーバー：クライアントからのリクエストを処理し、レスポンスを返します。

リクエストとレスポンス

すべてのMCP操作はリクエスト - レスポンスモードに基づいています。以下は簡単なやり取りの例です。

// 发起请求
var request = createRequest();
client.sendRequest(request);

// 处理响应
client.receiveResponse().thenAccept(response -> {
    System.out.println("收到响应: " + response.toString());
});

リソースとツールの管理

リソーステンプレート

リソーステンプレートを使用してリソースコンテンツを動的に生成します。

import io.modelcontextprotocol.schema.McpSchema;

public class McpExample {
    public static void main(String[] args) {
        // 创建一个简单的资源模板
        var resourceTemplate = new Template() {
            @Override
            public String getResourceId() {
                return "example_resource";
            }

            @Override
            public Map<String, Object> getParameters() {
                return Collections.emptyMap();
            }
        };

        // 应用资源模板生成内容
        McpSchema.applyTemplate(resourceTemplate);
    }
}

ツールの実行

カスタムツールを定義して実行します。

import io.modelcontextprotocol.tool.McpTool;

public class McpExample {
    public static void main(String[] args) {
        // 定义一个简单的工具
        var tool = new Tool() {
            @Override
            public String getName() {
                return "example_tool";
            }

            @Override
            public void execute(List<String> arguments, Callback<String> callback) {
                callback.onResult("执行完成: " + arguments);
            }
        };

        // 执行工具并获取结果
        var result = McpTool.execute(tool, List.of("arg1", "arg2"));
        System.out.println(result);
    }
}

📚 ドキュメント

一般的な規範

1. BOMの使用 - 常にMCP BOMを使用して、すべてのコンポーネントの互換性のあるバージョンを確保してください。
2. 接続の閉じる - 処理が完了したら、クライアントとサーバーのインスタンスを閉じてください。
3. エラーの処理 - すべてのMCP操作に適切なエラー処理を実装してください。
4. 入力の検証 - 処理する前にすべての入力データを検証してください。
5. 適切な転送メカニズムの選択 - 使用シナリオに応じて適切な転送方法を選択してください。

クライアント側

1. クライアントの再利用 - 単一のクライアントインスタンスを作成し、複数回使用してください。