Atlas MCP 服务器实现

关键词

AI上下文服务资源管理工具注册JSON-RPC

使用说明（简要概览）

  • 项目简介
    • 该仓库实现了一个 MCP 服务器的后端组件，用于向 LLM 客户端提供统一的上下文、资源、工具等能力。核心通过 MCP 的服务器端框架实现资源托管、工具注册与执行，以及 Prompt 模板渲染等功能，并通过 JSON-RPC 与前端/LLM 客户端通信。支持 STDIO（如 Claude Desktop/Aggregate 客户端）和 SSE 等传输模式，便于本地、浏览器及远端集成场景。
  • 主要功能点
    • MCP 服务器核心能力接入：资源（Resources）管理、工具（Tools）注册与执行、Prompt/模板渲染等接口。
    • JSON-RPC 通信：与 MCP 客户端互通的请求/响应模型，定义清晰的调用路径。
    • 传输模式：支持 StdIO 与 SSE 传输，方便本地开发与浏览器/远端使用。
    • 会话与健康检查：负责会话状态、服务器健康与生命周期管理，确保在不同传输模式下的健壮性。
    • 安全与隔离策略：通过后端插件和隔离后端实现，提供对资源与执行的控制边界。
  • 安装步骤
    • 克隆或下载本仓库后，进入 MCP 相关实现目录，安装依赖并构建。具体步骤请结合该项目的根级构建脚本和各插件的说明进行操作。
    • 运行时，请根据部署环境选择合适的传输模式（stdio 或 SSE），并确保 MCP 服务能正确加载和初始化。
  • 服务器配置（给 MCP 客户端的配置示例，JSON 格式，包含 server name、command、args 等）
    • 该配置用于 MCP 客户端在连接 MCP 服务器时描述需要启动的服务器信息、执行方式以及如何通讯。示例字段说明如下： { "serverName": "atlas-mcp-server", "transport": "stdio", "command": "bun", "args": ["run", "atlas-mcp-server-entry"], "workDir": "/path/to/atlas", "notes": "该服务器通过标准输入输出进行 JSON-RPC 通信；若使用 SSE，请将 transport 调整为 'sse'，并提供端口等必要参数。" } 说明
    • serverName: 唯一标识 MCP 服务器的名称，客户端使用以区分不同服务器实例。
    • transport: 通信传输模式，常见有 "stdio"（标准输入/输出）与 "sse"（基于 SSE 的传输）。
    • command/args: 启动服务器所需的可执行程序及参数，客户端不需要理解内部实现细节，仅需知道启动命令和参数。
    • workDir: 服务器工作目录（如有需要）。
    • notes: 额外说明，便于运维理解该配置的动机与适用场景。
  • 基本使用方法
    • 启动 MCP 服务器并确保其对外可用。
    • 使用 MCP 客户端发起 JSON-RPC 请求，服务器会按照 MCP 协议处理资源读取、工具调用、Prompts 获取与渲染等请求，返回标准的 JSON-RPC 响应。
    • 根据传输模式选择合适的前端集成方式（标准输出/流式输出等），以实现实时上下文反馈与交互。

服务器信息

访问项目