Spring Io MCP

🚀 Spring I/O MCP Server

このプロジェクトは、AIアシスタントがSpring I/O 2025カンファレンスのセッションデータにアクセスできるようにするModel Context Protocol (MCP)サーバーです。標準化されたMCPインターフェースを通じて、トーク、ワークショップ、講演者、スケジュールなどのカンファレンス情報を公開します。

✨ 主な機能

• カンファレンスセッションへのアクセス：Spring I/O 2025のセッションの完全なデータベース
• MCP準拠：AIとの統合のためにMCP標準と完全に互換性があります
• 豊富なセッションデータ：講演者、会場割り当て、セッションタイプ、時間などが含まれます
• Spring Boot統合：Spring Boot 3.5とSpring AI MCPサポートで構築されています
• JSONデータソース：JSON構成による柔軟なデータ管理

📦 インストール

プロジェクトの要件

依存関係

このプロジェクトでは、いくつかの重要な依存関係が使用されています。

• spring-boot-starter-web：Spring Bootのコアウェブ機能
• spring-ai-starter-mcp-server-webmvc：Spring AI MCPサーバーの実装
• spring-boot-starter-test：テストフレームワーク
• jackson-databind：JSON処理（Spring Bootに含まれています）

プロジェクトのビルド

このプロジェクトには、簡単にビルドできるようにMavenラッパースクリプトが含まれています。

# On Unix/macOS
./mvnw clean compile

# On Windows
mvnw.cmd clean compile

テストの実行

テストスイートを実行して、すべてが正しく動作することを確認します。

# Unix/macOS
./mvnw test

# Windows
mvnw.cmd test

💻 使用例

基本的な使用法

アプリケーションの実行

標準実行

Mavenを使用してアプリケーションをビルドして実行します。

# Build the JAR file
./mvnw clean package

# Run the application
java -jar target/spring-io-mcp-0.0.1-SNAPSHOT.jar

開発モード

開発時には、Mavenで直接実行できます。

./mvnw spring-boot:run

MCPサーバーの構成

このアプリケーションは、次の設定でMCPサーバーとして構成されています。

• Server Name: spring-io-sessions-mcp
• Version: 0.0.1
• Transport: STDIO (Standard Input/Output)
• Application Type: Non-web (console application)

⚠️ 重要提示

STDIOトランスポートを使用する場合、Spring Bootのバナーとログを無効にして、MCP通信の干渉を防ぐ必要があります。

# Disable banner and logging for STDIO transport
spring.main.banner-mode=off
logging.level.root=OFF

これらの設定がないと、Spring Bootの起動メッセージとログ出力がSTDIOを介したMCPプロトコル通信を破損させます。

高度な使用法

セッションデータ構造

サーバーは、次のように構造化されたセッションデータを扱います。

public record Session(
    String day, 
    String time, 
    String title, 
    String type, 
    String[] speakers, 
    String room
) {}

カンファレンスモデル

カンファレンス情報は、この構造を使用して表されます。

public record Conference(
    String name, 
    int year, 
    String[] dates, 
    String location, 
    List<Session> sessions
) {}

MCPツールの実装

コア機能は、MCPツールを通じて公開されます。

@Tool(
    name = "spring-io-sessions", 
    description = "Returns all sessions for Spring I/O 2025 Conference"
)
public List<Session> findAllSessions() {
    return sessions;
}

Springの構成

アプリケーションは、Springの構成を使用してMCPツールを登録します。

@Bean
public List<ToolCallback> springIOSessionTools(SessionTools sessionTools) {
    return List.of(ToolCallbacks.from(sessionTools));
}

セッションの読み込みプロセス

セッションは、アプリケーションの起動時にJSONから読み込まれます。

@PostConstruct
public void init() {
    try (InputStream inputStream = 
         TypeReference.class.getResourceAsStream("/sessions.json")) {
        var conference = objectMapper.readValue(inputStream, Conference.class);
        this.sessions = conference.sessions();
    } catch (IOException e) {
        throw new RuntimeException("Failed to read JSON data", e);
    }
}

📚 ドキュメント

データ構成

セッションタイプ

このカンファレンスには、さまざまなセッションタイプが含まれています。

• talks：技術的なプレゼンテーションと深掘り
• workshops：実践的な学習セッション
• keynote：主要なカンファレンスプレゼンテーション
• break：コーヒーブレイクとネットワーキング時間
• networking：社交イベントとコミュニティ構築
• logistics：登録と組織的なイベント

サンプルセッションデータ

セッションデータの構造の例を次に示します。

{
  "day": "2025-05-22",
  "time": "11:00-11:50",
  "title": "Demystifying Spring Boot Magic",
  "type": "talk",
  "speakers": ["Patrick Baumgartner"],
  "room": "Auditorium"
}

MCP統合

AIアシスタントへの接続

このサーバーは、MCPをサポートするAIアシスタントに接続できます。サーバーは次の機能を提供します。

1. セッションの検索：さまざまな基準でセッションを検索
2. 講演者情報：各セッションの講演者詳細にアクセス
3. スケジュールのナビゲーション：日付と時間でセッションを閲覧
4. 会場管理：会場のレイアウトとセッションの場所を理解

ツールの登録

MCPサーバーは、spring-io-sessionsツールを自動的に登録し、接続されたAIクライアントがカンファレンスデータを照会できるようにします。

開発ノート

プロジェクト構造

src/main/java/dev/danvega/spring_io_mcp/
├── Application.java          # Main application and MCP configuration
├── SessionTools.java         # MCP tool implementation
├── Session.java             # Session data model
└── Conference.java          # Conference data model

src/main/resources/
├── application.properties   # Spring configuration
└── sessions.json           # Conference session data

構成プロパティ

MCPサーバーの操作に必要な主要なアプリケーションプロパティは次のとおりです。

spring.ai.mcp.server.stdio=true
spring.ai.mcp.server.name=spring-io-sessions-mcp
spring.ai.mcp.server.version=0.0.1
spring.main.web-application-type=none

# Critical for STDIO transport - prevents output corruption
spring.main.banner-mode=off
logging.level.root=OFF

サーバーの拡張

新しいツールを追加するか、セッションデータを変更するには、次の手順を実行します。

1. sessions.jsonに新しいカンファレンス情報を追加します。
2. SessionToolsに新しい@Toolアノテーション付きのメソッドを追加します。
3. Application.javaで追加のツールコールバックを登録します。
4. サーバーを再構築して再起動します。

Spring I/O 2025カンファレンスの詳細

このサーバーには、次のカンファレンスの完全なセッションデータが含まれています。

• Conference：Spring I/O 2025
• Dates：2025年5月22 - 23日
• Location：Barcelona, Fira de Barcelona
• Sessions：80以上のトーク、ワークショップ、イベント
• Tracks：Springエコシステムのトピックをカバーする複数の並行トラック

このカンファレンスでは、Spring Framework、Spring Boot、Spring AI、クラウドネイティブ開発、および最新のJavaプラクティスに関する最先端のトピックが扱われます。

まとめ

Spring I/O MCPサーバーは、AIアシスタントとカンファレンスデータの間のギャップを埋め、Spring I/O 2025のセッション情報とのインテリジェントな対話を可能にします。AI搭載のカンファレンスアプリを構築したり、スマートなスケジューリングアシスタントを作成したり、カンファレンスナビゲーションツールを開発したりする場合、このMCPサーバーはAI強化型のカンファレンス体験の基盤を提供します。

AIとカンファレンスデータを統合する準備はできていますか？サーバーを実行し、お気に入りのMCP互換AIアシスタントに接続して、Spring I/Oセッションの豊かな世界を探索し始めましょう！