MCP Server Spring Java

🚀 Spring Boot Java で実装された MCP サーバー

Spring Boot と Java 21 を使用して実装された Model Context Protocol (MCP) サーバーです。このサーバーは、AI アシスタントのユーザー管理ツールを提供する MCP サーバーの作成方法を示しています。

✨ 主な機能

• Spring AI を使用して MCP サーバー機能を実装
• MCP インターフェースを通じてユーザー管理ツールを提供
• 同期通信モードをサポート
• 標準 I/O と Server-Sent Events (SSE) の伝送をサポート
• ユーザーデータのやり取りのために 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
• 同期通信モード
• 端末による標準 I/O ベースの通信をサポート
• SSE 通信のための /mcp/message エンドポイントを提供

利用可能なツール

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

• getAllUsers - すべてのユーザーを取得（ページング付き）
• getAllUsersDefault - すべてのユーザーを取得（デフォルトのページング）
• getUserById - ID で単一のユーザーを取得
• 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": "example"
        }
      }
    ]
  }
}

📄 ライセンス

このプロジェクトは Apache License 2.0 の下でライセンスされています。