Overlord MCP 服务端集成

关键词

Model Context ProtocolLLM context service资源与工具托管子进程 MCP 服务JSON-RPC

使用说明

  • 项目简介 Overlord 是一个面向开发者的 AI 经营与协作平台，在其架构中实现了对 MCP( Model Context Protocol ) 的服务器端支持，允许模型在统一的后端接口下访问资源、调用工具、获取和渲染 Prompt 模板，以及注册和管理外部 MCP 服务器。服务器通过 JSON-RPC/Socket.IO 与前端客户端通信，负责会话管理、能力声明与多传输协议的支持，提供安全、可扩展的上下文服务框架。

  • 主要功能点

    • MCP 核心能力：托管与暴露 Resources(资源)、Tools(工具) 与 Prompts(提示/模板)，以标准化的 JSON-RPC 交互方式供模型使用。
    • MCP 服务器管理：内建 MCP 子服务器的启动、初始化、崩溃自愈、重连，以及预置与自定义 MCP Preset 的加载与合并。
    • 统一通信桥接：通过 hub.js 提供的事件总线，将 MCP 相关事件与 UI、AI 流程及插件模块解耦并路由。
    • 会话与权限：内置会话管理、权限控制、角色与工具访问策略，以及计划/审批等工作流的耦合。
    • 多传输协议与探测：支持基于 Socket.IO 的实时通信、以及可扩展的 STDIO/SSE/WebSocket 传输方案（通过 MCP 与前端客户端协作传输）。
    • 持久化与配置：sqlite/文件存储、设置持久化、K/V 配置以及 MCP 服务器的注册与管理接口。

  • 安装步骤

    • 下载并安装依赖：在项目根目录执行 npm install。
    • 启动服务：执行 npm start（或使用 launcher.js 作为 OS 无关入口启动流程）。
    • MCP 服务器配置与启动：通过 Overlord 的 Settings → MCP Servers 增加 MCP 服务器条目，指定启动命令（如 uvx）及参数（如 minimax-coding-plan-mcp）。仓库内包含对 uvx 自动安装 MCP 服务器的支持，且内置 presets（minimax、github、filesystem、sequential_thinking）供快速接入。
    • 连接 MCP 客户端：MCP 客户端需提供一个 JSON 配置，包含服务器名称、启动命令及参数，来建立与 Overlord 的连接与通信。该配置用于 MCP 客户端发现并连接 MCP 服务器；客户端本身不需要在此处暴露实现细节。

  • MCP 服务器配置（供 MCP 客户端使用的配置信息，JSON 结构说明） serverName: minimax-coding-plan-mcp command: uvx args: ["minimax-coding-plan-mcp"] 说明:

    • serverName 表示 MCP 服务器的唯一标识，用于前端或管理界面在多服务器场景中区分。
    • command 为启动 MCP 服务器的可执行程序名称，Overlord 将按该命令启动子进程。
    • args 为该命令的参数数组，指向具体的 MCP 服务实现（如 minimax-coding-plan-mcp）。 注：这是 MCP 客户端需要的连接信息，Overlord 将负责推动 MCP 服务器的启动、初始化、以及与前端/LLM 的交互通道。实际部署时可将 minmaqx 相关 MCP 服务通过 uvx 安装、配置并在 Overlord 内部以子进程形式托管。

  • 基本使用方法

    1. 启动 Overlord：通过 npm start 启动后台服务，浏览器端将自动打开界面并连接服务器。
    2. 配置 MCP 服务器：在 Overlord 的 Settings → MCP Servers 中添加服务器，填写名称和启动指令（如 minimax-coding-plan-mcp），Overlord 将负责启动与管理该 MCP 服务器进程。
    3. MCP 服务器管理与监控：Overlord 提供预置的 MCP Presets、自动安装和重连能力，管理员可以添加自定义 MCP 服务器，平台会在后台处理子进程的崩溃恢复、连接重建等问题。
    4. 与 LLM 的交互：MCP 服务器一旦就绪，LLM 客户端可以通过规范的 JSON-RPC 请求读取 Resources、调用 Tools、获取 Prompts，并接收对应的 JSON-RPC 响应或通知。
    5. 安全与扩展：通过集中式的会话管理、权限策略以及插件体系，可以扩展更多的 MCP 功能与工具集，满足多场景的上下文服务需求。

  • 进阶使用提示

    • MCP 内置 presets 提供了快速接入的工具集，例如 minimax、github、filesystem、sequential_thinking，便于在不同场景下快速配置上下文源。
    • 使用 uvx 自动安装 MCP 服务可减轻运维负担，Overlord 负责在首次需要时自动安装并启动 MCP 服务。
    • MCP 服务的管理数据与设置保存在 overlord 的数据目录下（如 .overlord/mcp-servers.json 等），便于跨会话与跨设备共享配置。

服务器信息

访问项目