Dan Vega Courses

🚀 Spring AI MCP コース情報サーバー

このアプリケーションは、Spring Boot をベースに構築されたモデル制御プロトコル（MCP）サーバーで、コース情報を提供します。軽量なサーバーを作成し、Spring AI MCP フレームワークを通じてコースデータを公開します。これにより、AI モデルがカスタムデータサービスとやり取りし、標準化されたツールを使用できるようになります。

サーバーは以下の 2 つの主要なツールを提供します。

• 利用可能なすべてのコースを取得するツール
• タイトルで特定のコースを検索するツール

この実装は、独自のモデル制御プロトコルサーバーを作成する、または Spring AI を通じて外部データソースを AI モデルと統合するのに最適なスタート地点です。

🚀 クイックスタート

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

   git clone https://github.com/your-username/spring-ai-mcp.git
   cd spring-ai-mcp
   

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

   mvn clean install
   

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

   java -jar target/courses-0.0.1-SNAPSHOT.jar
   

✨ 主な機能

このサーバーは、コース情報を提供するための 2 つの主要なツールを提供します。

• 利用可能なすべてのコースを取得するツール
• タイトルで特定のコースを検索するツール

📦 インストール

プロジェクト要件

• Java 24
• Maven 3.8+
• Spring Boot 3.4.4
• Spring AI 1.0.0 - M6

依存関係

このプロジェクトは、以下の主要な依存関係に依存しています。

• Spring AI MCP サーバー：MCP 互換のサーバーを作成するための基盤を提供します。

  <dependency>
      <groupId>org.springframework.ai</groupId>
      <artifactId>spring-ai-mcp-server-spring-boot-starter</artifactId>
  </dependency>
  

• デモ用の Spring Boot Starter Web：MVC アプリケーションを構築するための Web コンポーネントを提供します。

  <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-web</artifactId>
  </dependency>
  

💻 使用例

基本的な使用法

1. すべてのコースを取得する

   curl http://localhost:8080/courses
   

2. コースを検索する

   curl "http://localhost:8080/search?keyword=Java"
   

高度な使用法

1. サービスクラスを作成する

import org.springframework.stereotype.Service;

@Service
public class CourseService {
    public List<Course> getAllCourses() {
        return List.of(
            new Course(1L, "Introduction to Java"),
            new Course(2L, "Advanced Python Programming")
        );
    }

    @Tool(name = "search_courses", description = "Search for courses containing a keyword")
    public List<Course> searchCourses(String keyword) {
        // ここに検索ロジックを追加
        return this.getAllCourses().stream()
            .filter(course -> course.getTitle().toLowerCase().contains(keyword.toLowerCase()))
            .collect(Collectors.toList());
    }
}

2. Course データ転送オブジェクト（DTO）を作成する

import java.util.Objects;

public record Course(
    Long id,
    String title
) {
    @Override
    public boolean equals(Object o) {
        if (this == o) return true;
        if (o == null || getClass() != o.getClass()) return false;
        Course course = (Course) o;
        return Objects.equals(id, course.id);
    }

    @Override
    public int hashCode() {
        return Objects.hash(id);
    }
}

📚 ドキュメント

プロジェクト構造

src/main/java/
├── CourseService.java       # コースデータを提供するビジネスロジック
└── MCPServerApplication.java # Spring Boot アプリケーションを起動するメインアプリケーションクラス

MCP サーバーの設定

application.properties ファイルで以下の設定を行います。

# MCP サーバーのポートを設定する
server.port = 8080

# その他の Spring Boot 設定...

結論

この例を通じて、Spring AI の MCP サーバーを使用してカスタムサービスを公開する方法がわかります。これは、AI モデルとやり取りする必要があるすべてのバックエンドサービスに非常に役立ちます。

詳細情報については、公式ドキュメントを参照してください。