Spring Io MCP

🚀 Spring I/O MCP 服務器

Spring I/O MCP 服務器是一個模型上下文協議（MCP）服務器，它為 AI 助手提供訪問 Spring I/O 2025 會議會話數據的途徑。該服務器通過標準化的 MCP 接口公開會議信息，包括演講、研討會、演講者和日程安排細節。

🚀 快速開始

構建項目

項目包含 Maven 包裝器腳本，便於構建：

# 在 Unix/macOS 系統上
./mvnw clean compile

# 在 Windows 系統上
mvnw.cmd clean compile

運行測試

通過運行測試套件來驗證一切是否正常工作：

# Unix/macOS
./mvnw test

# Windows
mvnw.cmd test

如何運行應用程序

標準執行

使用 Maven 構建並運行應用程序：

# 構建 JAR 文件
./mvnw clean package

# 運行應用程序
java -jar target/spring-io-mcp-0.0.1-SNAPSHOT.jar

開發模式

在開發時，你可以直接使用 Maven 運行：

./mvnw spring-boot:run

MCP 服務器配置

應用程序被配置為 MCP 服務器，具有以下設置：

• 服務器名稱：spring-io-sessions-mcp
• 版本：0.0.1
• 傳輸方式：STDIO（標準輸入/輸出）
• 應用程序類型：非 Web（控制檯應用程序）

⚠️ 重要提示

使用 STDIO 傳輸時，必須禁用 Spring Boot 的橫幅和日誌記錄，以防止干擾 MCP 通信：

# 禁用 STDIO 傳輸的橫幅和日誌記錄
spring.main.banner-mode=off
logging.level.root=OFF

如果沒有這些設置，Spring Boot 的啟動消息和日誌輸出會破壞通過 STDIO 進行的 MCP 協議通信。

✨ 主要特性

• 會議會話訪問：擁有 Spring I/O 2025 會議會話的完整數據庫。
• MCP 合規性：完全兼容 MCP 標準，便於與 AI 集成。
• 豐富的會話數據：包含演講者、會議室分配、會話類型和時間安排等信息。
• Spring Boot 集成：基於 Spring Boot 3.5 和 Spring AI MCP 支持構建。
• JSON 數據源：通過 JSON 配置實現靈活的數據管理。

📦 安裝指南

項目要求

• Java：版本 24 或更高
• Maven：3.6+（包含包裝器）
• Spring Boot：3.5.0
• Spring AI：1.0.0

依賴項

項目使用了幾個關鍵依賴項：

• spring-boot-starter-web：Spring Boot 核心 Web 功能。
• spring-ai-starter-mcp-server-webmvc：Spring AI MCP 服務器實現。
• spring-boot-starter-test：測試框架。
• jackson-databind：JSON 處理（包含在 Spring Boot 中）。

💻 使用示例

基礎用法

會話數據結構

服務器處理的會話數據結構如下：

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          # 主應用程序和 MCP 配置
├── SessionTools.java         # MCP 工具實現
├── Session.java             # 會話數據模型
└── Conference.java          # 會議數據模型

src/main/resources/
├── application.properties   # Spring 配置
└── sessions.json           # 會議會話數據

配置屬性

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

# 對於 STDIO 傳輸至關重要 - 防止輸出損壞
spring.main.banner-mode=off
logging.level.root=OFF

擴展服務器

要添加新工具或修改會話數據，請按以下步驟操作：

1. 使用新的會議信息更新 sessions.json。
2. 在 SessionTools 中添加新的 @Tool 註解方法。
3. 在 Application.java 中註冊額外的工具回調。
4. 重新構建並重啟服務器。

Spring I/O 2025 會議詳情

該服務器包含以下完整的會話數據：

• 會議：Spring I/O 2025
• 日期：2025 年 5 月 22 - 23 日
• 地點：巴塞羅那，巴塞羅那國際會展中心
• 會話：80 多個演講、研討會和活動
• 主題：多個並行主題，涵蓋 Spring 生態系統主題

會議涵蓋了 Spring 框架、Spring Boot、Spring AI、雲原生開發和現代 Java 實踐等前沿主題。

🔚 總結

Spring I/O MCP 服務器架起了 AI 助手與會議數據之間的橋樑，實現了與 Spring I/O 2025 會話信息的智能交互。無論你是在構建 AI 驅動的會議應用程序、創建智能日程安排助手，還是開發會議導航工具，這個 MCP 服務器都為增強會議體驗的 AI 應用提供了基礎。

準備好將 AI 與會場數據集成了嗎？先運行服務器，再將其連接到你喜歡的支持 MCP 的 AI 助手，探索豐富的 Spring I/O 會話世界！