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 接口查看运行状态(若客户端通过轻量化接口访问,可做健康轮询)。
- 连接方式