MCP Server using Spring Boot Java

Spring Boot Java を使用した MCP サーバー

Spring Boot と Java 21 で構築された Model Context Protocol（MCP）サーバーの実装です。このプロジェクトでは、AI アシスタント向けにユーザー管理ツールを提供する MCP サーバーの作成方法を紹介します。

機能

• Spring AI を使用して MCP サーバー機能を実装
• MCP 経由でユーザー管理ツールを公開
• 同期通信モード
• 標準入出力と Server-Sent Events トランスポートをサポート
• ユーザーデータの取得に DummyJSON 外部 API を統合

技術

• Java 21
• Spring Boot 3.4.3
• Spring AI（Model Context Protocol）
• Project Lombok
• Maven

はじめに

前提条件

• Java 21 以上
• Maven

インストール

1. リポジトリをクローンします

git clone https://github.com/yourusername/mcp-spring-java.git
cd mcp-spring-java

2. プロジェクトをビルドします

mvn clean package

3. アプリケーションを実行します

java -jar target/mcp-spring-java-0.0.1-SNAPSHOT.jar

設定

MCP サーバーは application.yml で設定します。

• サーバーはポート 8090 で実行されます
• サーバー名：my-dummy-users-server
• 同期通信モード
• ターミナルベースの通信向けに STDIO トランスポートをサポート
• SSE 通信向けに /mcp/message エンドポイントを公開

利用可能なツール

サーバーは以下のユーザー管理ツールを公開します。

• getAllUsers - ページネーションを使用して全ユーザーを取得
• getAllUsersDefault - デフォルトのページネーションで全ユーザーを取得
• getUserById - ID でユーザーを 1 人取得
• searchUsers - クエリでユーザーを検索
• addUser - 新しいユーザーを追加
• updateUser - ユーザーを更新
• deleteUser - ユーザーを削除

Postman でのテスト

Postman を使用して MCP サーバーのエンドポイントをテストできます。

1. MCP サーバーを起動します

2. Postman を開いて新しいリクエストを作成します。

   • メソッド：POST
   • URL：http://localhost:8090/mcp/message
   • ヘッダー：
     • Content-Type: application/json
     • Accept: application/json

3. リクエストボディには、利用可能なツールを呼び出すために以下の JSON 形式を使用します。

{
  "message": {
    "toolCalls": [
      {
        "id": "call-123",
        "name": "[TOOL_NAME]",
        "parameters": {
          "[PARAMETER_NAME]": "[PARAMETER_VALUE]"
        }
      }
    ]
  }
}

リクエスト例

全ユーザーを取得（デフォルトのページネーション）

{
  "message": {
    "toolCalls": [
      {
        "id": "call-123",
        "name": "getAllUsersDefault",
        "parameters": {}
      }
    ]
  }
}

ID でユーザーを取得

{
  "message": {
    "toolCalls": [
      {
        "id": "call-123",
        "name": "getUserById",
        "parameters": {
          "id": 1
        }
      }
    ]
  }
}

ユーザーを検索

{
  "message": {
    "toolCalls": [
      {
        "id": "call-123",
        "name": "searchUsers",
        "parameters": {
          "query": "John"
        }
      }
    ]
  }
}

レスポンスには、ツールの実行結果を含む JSON オブジェクトが含まれます。

MCP クライアントでの使用

以下の設定を使用して、MCP クライアントアプリケーションでこのサーバーを設定できます。

{
  "mcpServers": {
    "dummy-user-server": {
      "command": "java",
      "args": [
        "-Dspring.ai.mcp.server.stdio=true",
        "-Dspring.main.web-application-type=none",
        "-Dlogging.pattern.console=",
        "-jar",
        "path/to/mcp-spring-java-0.0.1-SNAPSHOT.jar"
      ]
    }
  }
}

ライセンス

このプロジェクトは、LICENSE ファイルに記載された条件に基づいてライセンスされています。