Springone MCP

🚀 Spring Into MCP

Spring Into MCP 是一個基於 Spring AI 構建的示範 MCP（模型上下文協議）服務器，它能夠提供有關 SpringOne 會議場次和演講者的信息。這個項目展示瞭如何利用 Spring AI 搭建一個 MCP 服務器，為 AI 模型與外部數據源和工具的連接提供了標準化的解決方案。

🚀 快速開始

前提條件

• 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 服務器具備以下三大主要功能：

工具

• springone-sessions-by-date：按會議日期分組獲取場次數量
• springone-sessions：檢索 2025 年 SpringOne 所有場次的詳細信息

提示模板

• 針對會議提供的場次推薦提示模板

資源

• 演講者信息和背景資料

💻 使用示例

與 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：包含所有 2025 年 SpringOne 會議場次數據，供工具查詢使用

📚 詳細文檔

公共 MCP 服務器（HTTP + SSE）

默認情況下，此 MCP 服務器以 STDIO 模式運行，用於與 Claude Desktop 直接集成。不過，你也可以將其作為公共 HTTP 服務器運行，使用 Server-Sent Events（SSE）以實現更廣泛的訪問。

配置

項目包含兩種配置文件：

• 默認（STDIO）：application.properties
  • 使用標準輸入/輸出進行通信
  • 非常適合與 Claude Desktop 集成
  • 無網絡暴露
• 公共（HTTP + SSE）：application-sse.yaml
  • 作為 Web 服務器在端口 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 服務器
  • application.properties（STDIO 與 SSE - 代碼相同，但配置不同）
  • 展示場次數據
• 模型
  • 會議
  • 場次
• 工具
  • SessionTools
  • 討論其他工具但暫不實現
  • 添加工具回調
  • 構建 mvn clean package -DskipTests
  • 測試 npx @modelcontextprotocol/inspector
• 提示模板
  • Conference Prompts
  • 構建並測試
• 資源
  • SpeakerResource
  • 構建並測試
• Claude Desktop
  • 配置
  • 演示提示
    • 今年 SpringOne 會議有多少場活動？
    • 我是一名對 AI 和 MCP 感興趣的 Java 開發者，今年 SpringOne 會議能為我推薦一些場次嗎？
    • Dan Vega 的那場活動聽起來很有趣，能給我一些他的背景信息嗎？
  • 提示模板
  • 資源
• HTTP + SSE
  • 將其轉變為公共 MCP 服務器