Open-Hivemind MCP Server

关键词

多任务协同LLM上下文服务JSON-RPC工具注册提示模板渲染

使用说明

  • 项目简介 Open-Hivemind 提供一个可扩展的 MCP 服务器框架，允许通过统一的后端来托管资源、注册工具、定义并渲染提示模板，并通过 JSON-RPC 与 LLM 客户端进行交互，帮助实现集中化的上下文服务、能力声明和丰富的交互模式。

  • 主要功能点

    • 资源管理：以结构化的资源模型向客户端暴露可访问的数据源与数据访问能力。
    • 工具注册与执行：注册外部工具，LLM 可以通过服务器发起对外部功能的调用。
    • 提示模板定义与渲染：集中管理可自定义的 Prompt 模板，与运行时上下文进行渲染。
    • JSON-RPC 通信：服务器端以标准 JSON-RPC 进行请求处理与响应返回，支持资源读取、工具调用、提示获取等操作。
    • 会话与能力管理：会话状态、能力声明、以及对多会话、多客户端场景的管理。
    • 多传输协议支持：包括 Stdio、SSE、WebSocket 等传输方案，以满足不同部署和客户端需求。
    • 安全与扩展性：内置守卫、速率限制、访问控制等安全特性，并可通过插件扩展资源、工具及模板渲染能力。

  • 安装步骤

    1. 克隆仓库并进入项目目录。
    2. 安装依赖：npm install
    3. 启动开发服务器：npm run dev
    4. 访问 WebUI 配置与运行参数（如需要）并通过 MCP 客户端进行连接。

  • 服务器配置（供 MCP 客户端连接所需的 JSON 配置示例） 说明：以下配置用于描述 MCP 服务器实例的启动方式与连接信息，便于 MCP 客户端在本地或远程环境中启动并连接。实际配置请以运行环境为准。

    [ { "serverName": "open-hivemind-core", "transport": "WebSocket", "host": "0.0.0.0", "port": 4000, "description": "核心 MCP 服务，暴露资源、工具与提示模板的 JSON-RPC 接口" }, { "serverName": "open-hivemind-stdio", "transport": "Stdio", "command": "node", "args": ["start.js"], "description": "通过标准输入输出进行 MCP 通信的服务实例，适合管道化部署" } ]

    配置要点说明

    • serverName：唯一标识一个 MCP 服务器实例的名称，客户端通过名称定位目标服务。
    • transport：传输协议类型，常见为 WebSocket、Stdio，后者适用于进程间通信或容器内通讯。
    • host/port：WebSocket 模式下的监听地址与端口。
    • command/args：若客户端需要通过外部进程启动服务器，请提供启动命令及参数，便于自动化启动。

  • 基本使用方法（如何与 MCP 客户端对接）

    1. 启动 MCP 服务器实例（如 Open-Hivemind Core），确保网络可达。
    2. MCP 客户端读取服务器配置，按服务器名称建立连接（通过 JSON-RPC），并在会话中声明所需资源、工具和提示模板。
    3. 客户端发送读取资源、调用工具、获取 Prompt 的请求，服务器返回标准化的 JSON-RPC 响应。
    4. 如使用多传输协议，客户端可选择 WebSocket 或 Stdio 等通道进行通信，确保认证与权限控制到位。
    5. 通过内置的会话与能力管理，确保跨会话的上下文一致性与资源的正确访问权限。

  • 注意事项

    • MCP 客户端需要的仅是服务器名称、以及启动命令和参数，用以建立连接并执行相应的接口调用。
    • 本仓库提供了资源、工具、Prompts 的管理能力及相关单元测试，具备完整的后端实现与测试覆盖，适合作为 MCP 服务端的基础框架。

服务器信息

访问项目