使用说明（Markdown 格式）：

• 项目简介 ToastLabPlus MCP 服务器是一套用 Java Spring Boot 实现的后端服务，采用 MCP 规范提供资源、工具（Tools）及提示模板（Prompts）的注册、管理与执行能力，支持通过综合 API 和工具调用的方式向 LLM 客户端提供结构化上下文和功能。

• 主要功能点

  • MCP 服务端能力：注册与暴露工具、资源与提示模板，供客户端通过 MCP 发现、调用与渲染。
  • 工具执行：通过 McpToolService 暴露工具，llm 可调用并接收结构化返回数据。
  • 数据与权限管理：基于 Spring Security 实现的认证/授权，管理员权限分级控制对分会和成员的操作。
  • 多后端协作：与 FastAPI/ Gemini、Flutter 前端和 Google Cloud 资源整合，支持云存储、模板解析、议程生成等场景。
  • 客户端对接：提供 /mcp 路径的工具服务，便于 MCP 客户端初始化、查询工具及执行工具。

• 安装步骤

  • 需求与构建
    • 使用 Maven 构建后端模块，或按项目本地开发环境直接使用 mvn spring-boot:run 启动 MCP 服务。
  • 启动 MCP 服务器
    • 在后端根目录执行构建命令后启动 MCP 服务（参考项目中的后端模块，常用命令：mvn spring-boot:run）。
  • 配置依赖
    • 配置数据库（PostgreSQL）以及 GCP 服务（存储、模板等），按照项目中的文档和注释完成环境变量与凭据设置。
  • 客户端准备
    • MCP 客户端需要与 MCP 服务器建立连接，获取工具声明、调用工具并接收结果。配套的 Python 客户端示例在仓库中提供参照实现。

• 服务器配置（MCP 客户端需要的配置信息为 JSON 格式，包含 server_name、command、args 等） 要求的配置信息示例（请按实际环境填入具体参数）： { "server_name": "toastlabplus-mcp-server", "command": "mvn", "args": [ "-f", "backend/mcp-server/pom.xml", "spring-boot:run" ] // 注：以上启动方式仅为 MCP 客户端需要的启动信息示例，实际环境可使用打包后的 JAR 启动。字段用于描述服务器名称与启动命令参数，便于 MCP 客户端在对接时了解如何启动服务器。 }

• 基本使用方法

  • 启动后端
    • 使用 Maven 编译并运行后端 MCP 服务，确保数据库、存储以及相关依赖就绪。
  • 发现与调用工具
    • MCP 客户端通过 /mcp 路径获取可用工具列表，选择需要的工具并以约定的输入参数调用。
  • 数据与安全
    • 通过 JWT/权限控制实现对特定资源和管理员操作的授权，普通成员与平台管理员的权限有差异化限制。
  • 集成与扩展
    • 将 MCP Server 与前端 Flutter 应用、Chat 后端（Gemini + ADK）及 Google Cloud Storage 等进行对接，构成端到端的对话型上下文服务。