Atmosphere MCP 服务端

关键词

模型上下文服务资源管理工具执行JSON-RPC提示模板

使用说明（Markdown 格式）

  • 项目简介

    • Atmosphere 提供多种传输协议的通用 API，其中 MCP 模块实现了一个可运行的 MCP 服务器端。该服务器负责托管资源、注册并执行工具、定义和渲染提示模板，并以标准的 JSON-RPC 形式与 LLM 客户端通信，向其提供上下文信息以及对外部功能的调用能力。

  • 主要功能点

    • 资源管理（Resources）：托管可供 LLM 访问的数据与上下文信息的资源库，支持按需读取与写入。
    • 工具注册与执行（Tools）：注册外部功能并允许 LLM 通过 MCP 客户端调用，支持参数化和流式输出等能力。
    • 提示模板（Prompts）：定义、渲染并渲染系统提示、对话模版等，便于 LLM 进行上下文对话。
    • JSON-RPC 通信：服务器端接收和响应 MCP 客户端的 JSON-RPC 请求，支持读取资源、执行工具、获取 prompts 等操作。
    • 会话与能力声明：会话管理、能力声明、以及对不同传输协议的适配。
    • 传输协议：WebSocket、SSE、Long-Polling、以及潜在的 stdio 等实现，提供传输层的抽象。
    • 安全性与扩展性：SPI/插件化能力，便于接入多种 AI 框架和工具桥接。

  • 安装步骤

    • 从仓库获取 MCP 模块（通常为 atmosphere-mcp 子模块），并进行打包构建。
    • 典型做法是使用 Maven 或 Maven Wrapper 运行：进入项目根目录后执行 mvnw spring-boot:run（或 mvn spring-boot:run），以启动 MCP 服务器。若项目提供了示例应用，请参考生成的示例应用中的启动命令。

  • 服务器配置（MCP 服务器端面向 MCP 客户端的配置示例）

    • MCP 客户端需要连接到 MCP 服务器来读取资源、调用工具和获取 Prompts；本段描述服务器侧的配置信息，供 MCP 客户端在搭建对接时参考。配置信息以 JSON 格式呈现，包含服务器名称、启动命令及参数等注释信息（注释仅供理解，实际客户端不需要这些注释）。
    • 服务器名称（serverName）： Atmosphere-MCP-Server
    • 启动命令（command）： ./mvnw
    • 启动参数（args）： ["spring-boot:run"]
    • 备注：服务器默认监听端口通常为 8080（如需改动，请在应用配置中调整）。MCP 客户端需要将上述服务器地址、端口以及传输协议等信息作为连接目标，并在连接建立后以 MCP 的 JSON-RPC 请求格式进行交互。

  • 基本使用方法

    • 启动服务器后，客户端通过 MCP 的 JSON-RPC 请求向服务器发起以下操作：
      • 读取资源：请求服务器端某一资源的内容或元数据。
      • 调用工具：按工具名称与参数调用外部功能，获取结果或流式输出。
      • 获取 Prompt：获取并渲染系统或对话提示模板，用于驱动 LLM 的对话。
    • LLM 客户端应根据 MCP 的响应进行后续处理，例如将资源数据注入会话、对输出进行流式处理等。

  • 备注

    • 该 MCP 服务端属于社区 Atmosphere 框架的一部分，作为后端服务器端实现，具有完整的资源、工具、Prompts 的管理能力，且对外提供标准的 JSON-RPC 接口以供 MCP 客户端调用。
    • 如需快速尝试，可参考仓库中的示例与模板，使用生成器快速搭建一个带 MCP 功能的后端应用，并通过相应的客户端进行交互。

  • 重要提示

    • MCP 客户端的配置与连接信息应仅在客户端侧使用，服务器端的配置信息应在 MCP 服务端环境中进行正确的暴露与授权，确保资源和工具的访问控制符合安全策略。

服务器信息

访问项目