DivineOS MCP Server

使用说明(Markdown 格式)

  • 项目简介

    • DivineOS MCP Server 是一个基于 MCP(Model Context Protocol)的后端服务器,实现了资源、工具、提示等能力的注册、读取与执行,提供 JSON-RPC 通信接口,便于 MCP 客户端调用外部功能与获取上下文信息。
  • 主要功能点

    • 支持通过 MCP 协议暴露大量 Tools(工具),如内存操作、管线处理、学习与评估、治理与执行等。
    • 提供服务器端实现,包含对请求的处理、响应返回,以及会话上下文与权限约束管理。
    • 支持两种传输模式:标准输入输出(stdio)和 HTTP 传输(通过环境变量或启动参数开启)。
    • 集成内置的剖面化与治理流程,允许 MCP 客户端执行复杂的工作流与管线。
    • 具备简单的启动脚本与运行入口,方便直接运行作为 MCP 服务器端。
  • 安装步骤

    • 克隆仓库并进入目录
    • 安装依赖:确保已安装 MCP SDK(pip install mcp)
    • 启动 MCP 服务器
      • 通过标准输入输出模式运行: python divineos_mcp_server.py
      • 或通过 HTTP 传输模式运行: DIVINEOS_MCP_HTTP=1 python divineos_mcp_server.py 说明:启动时若启用 http 传输,MCP 客户端可通过 HTTP 与服务器交互;未启用时默认使用 stdio 传输。
  • 服务器配置(MCP 客户端所需,示例配置仅用于参考,实际客户端无需包含代码)

    • 配置 JSON(服务器端供客户端了解启动信息用的元信息,包含服务器名称、启动命令与参数) { "server_name": "DivineOS MCP Server", "command": "python3", "args": ["divineos_mcp_server.py"], "transport": "stdio", "notes": "默认使用 stdio 传输。若要启用 HTTP 传输,请在启动时添加 --http 或设置 DIVINEOS_MCP_HTTP=1。" }

    • 备用 HTTP 传输配置(如需通过 HTTP 与 MCP 客户端通信) { "server_name": "DivineOS MCP Server (HTTP)", "command": "python3", "args": ["divineos_mcp_server.py", "--http"], "transport": "streamable-http", "notes": "通过 HTTP 传输,适合无终端环境的 MCP 客户端接入。" }

  • 基本使用方法

    • 连接方式
      • 使用 MCP 客户端连接到服务器,按所选传输模式进行请求与响应交互。
    • 调用工具
      • 通过 MCP 客户端发送对工具的请求(如 memory_store、pipeline_process 等),获取标准化的 JSON-RPC 响应。
    • 资源与读取
      • 客户端可通过相应的 MCP 方法读取服务器暴露的资源与状态,形成统一的上下文管道。
    • 日常运维
      • 使用服务器自带的 health/status 接口查看运行状态(若客户端通过轻量化接口访问,可做健康轮询)。

服务器信息