Springone MCP

🚀 Spring Into MCP

Spring AIを用いて構築されたデモ用のMCP（Model Context Protocol）サーバーで、SpringOneのセッションやスピーカーに関する情報を提供します。

🚀 クイックスタート

前提条件

• Java 21+
• Maven 3.6+

ビルドと実行

# プロジェクトをビルドする
mvn clean package -DskipTests

# サーバーを実行する
java -jar target/springone-mcp-0.0.1-SNAPSHOT.jar

サーバーのテスト

# MCP Inspectorを使用してサーバーをテストする
npx @modelcontextprotocol/inspector

✨ 主な機能

このMCPサーバーは主に3つの機能を提供します。

ツール

• springone-sessions-by-date：会議日ごとにセッション数を取得する
• springone-sessions：SpringOne 2025のすべてのセッション詳細を取得する

プロンプト

• セッション推薦用の会議固有のプロンプトテンプレート

リソース

• スピーカー情報と経歴

📦 インストール

Claude Desktopでの使用

設定

このサーバーをClaude Desktopの設定ファイルに追加します。

場所:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "springone-conference": {
      "command": "java",
      "args": [
        "-jar",
        "/Users/vega/Downloads/springone-mcp/target/springone-mcp-0.0.1-SNAPSHOT.jar"
      ]
    }
  }
}

注意: パスを実際のプロジェクトの場所に合わせて更新してください。

クエリの例

設定が完了したら、Claudeに以下のような質問をすることができます。

• "今年のSpringOneには何個のセッションがありますか？"
• "Java開発者にセッションをおすすめできますか？"
• "AIとMCPに興味がある人にはどのセッションがありますか？"
• "Dan Vegaの経歴と専門分野は何ですか？"

Claudeは自動的にMCPサーバーのツールとリソースを使用して、正確で最新の回答を提供します。

📚 ドキュメント

プロジェクト構造

src/main/java/dev/danvega/springone/
├── Application.java         # MCP設定を含む主要なSpring Bootアプリケーション
├── Conference.java          # 会議データモデル
├── Session.java             # セッションデータモデル
├── SessionTools.java        # セッションクエリ用のMCPツール
├── ConferencePrompts.java   # MCPプロンプトテンプレート
└── SpeakersResource.java    # スピーカー情報用のMCPリソース

src/main/resources/
└── data/
    └── sessions.json        # 会議セッションデータ

主要コンポーネント

• SessionTools: セッションデータ取得用の呼び出し可能な関数を提供する
• ConferencePrompts: 一般的な会議関連のクエリ用のテンプレート
• SpeakersResource: スピーカー情報を含む静的リソース
• sessions.json: ツールがクエリするすべてのSpringOne 2025セッションデータを含む

公開MCPサーバー（HTTP + SSE）

デフォルトでは、このMCPサーバーはClaude Desktopとの直接統合のためにSTDIOモードで実行されます。ただし、Server-Sent Events（SSE）を使用して公開HTTPサーバーとして実行することもでき、より広くアクセス可能になります。

設定

プロジェクトには2つの設定プロファイルが含まれています。

デフォルト（STDIO）: application.properties

• 標準入出力を使用して通信する
• Claude Desktopとの統合に最適
• ネットワーク公開なし

公開（HTTP + SSE）: application-sse.yaml

• ポート8080でウェブサーバーとして実行する
• リアルタイム通信にServer-Sent Eventsを使用する
• リモートクライアントからHTTPでアクセス可能

公開サーバーとしての実行

# プロジェクトをビルドする
mvn clean package -DskipTests

# SSEプロファイルで実行する
java -jar target/springone-mcp-0.0.1-SNAPSHOT.jar --spring.profiles.active=sse

公開サーバーのテスト

実行中に、MCPサーバーのエンドポイントをテストすることができます。

# サーバーの状態を確認する
curl http://localhost:8080/mcp/status

# 利用可能なツールをリストする
curl http://localhost:8080/mcp/tools

# ツール呼び出しをテストする
curl -X POST http://localhost:8080/mcp/tools/springone-sessions-by-date \
  -H "Content-Type: application/json"

これにより、MCPサーバーを公開して、HTTPを介してMCP互換のクライアントからアクセスできるようになります。

アジェンダ

• スライド
• デモの始め方
  • ブラウザタブ:
    • https://claude.ai/new
    • https://start.spring.io/
    • https://docs.spring.io/spring-ai/reference/index.html
    • https://modelcontextprotocol.io/docs/getting-started/intro
• Claude（ウェブまたはデスクトップ）に今年のSpringOneに何個のセッションがあるか尋ねる
  • モデルはこのデータで訓練されていない
  • これで質問に答えるために必要なデータを収集しようとツールを呼び出す
• MCPサーバーを作成する
  • start.spring.io
  • Web, MCP Server
  • application.properties (STDIO vs SSE - コードは同じで、設定が異なる)
  • セッションデータを表示する
• モデル
  • Conference
  • Sessions
• ツール
  • SessionTools
  • 追加のツールについて議論するが実装しない
  • ツールコールバックを追加する
  • mvn clean package -DskipTestsでビルドする
  • npx @modelcontextprotocol/inspectorでテストする
• プロンプト
  • Conference Prompts
  • ビルドとテスト
• リソース
  • SpeakerResource
  • ビルドとテスト
• Claude Desktop
  • 設定
  • デモプロンプト
    • 今年のSpringOneには何個のセッションがありますか？
    • 私はAIとMCPに興味があるJava開発者です。今年のSpringOneで私にセッションをおすすめできますか？
    • Dan Vegaのセッションが面白そうです。彼の背景情報を教えてくれますか？
  • プロンプト
  • リソース
• HTTP + SSE
  • これを公開MCPサーバーに変える