NeuroVerse Governance MCP Server

关键词

资源管理JSON-RPC工具执行治理会话管理模型上下文治理

使用说明

  • 项目简介 NeuroVerse Governance MCP 服务器是一套用来与支持 MCP 标准的客户端进行安全、可扩展的上下文服务交互的后端组件。它通过 JSON-RPC 2.0 框架接收来自客户端的请求（如读取资源、注册/执行工具、获取与渲染 Prompts），并返回 JSON-RPC 响应。服务器端负责会话管理、能力声明，以及对外暴露的工具和资源的治理执行。
  • 主要功能点
    • MCP 协议核心能力：实现 initialize、tools/list、tools/call 等核心请求/响应流程，遵循 JSON-RPC 2.0 规范通信。
    • 资源与工具治理: 根据传入世界定义，对工具执行进行治理（提前评估、阻止、等待人工批准等）。注册可治理的工具集合并在执行前进行治理评估。
    • Plan 与会话集成：可加载计划(plan)并在工具执行前后，与计划引擎结合进行阶段性治理与进度追踪。
    • 安全与证据：在执行过程中记录证据与溯源信息，便于审计和追踪。
    • 多种输出与扩展：设计为可扩展的服务器框架，理论上支持 Stdio、SSE、WebSocket 等传输方式以实现 MCP 的多种传输协议。
    • 与现有治理引擎深度整合：通过 evaluateGuard、plan-engine 等核心模块实现策略一致性。
  • 安装与运行步骤
    • 先安装/node 环境（Node.js 18+）。
    • 将代码构建成可执行的 JavaScript（通常通过项目的构建流程，将 TypeScript 编译为 JavaScript）。
    • 使用命令启动 MCP 服务器（示例路径仅供参考，请按实际构建产物路径执行）： node dist/runtime/mcp-server.js --world ./worlds/configurator_governance_v1 --plan plan.json
    • 服务器启动后，客户端通过 MCP 协议的 JSON-RPC 调用与服务器通信，服务器按请求进行处理并返回结果。
  • 服务器配置（MCP 客户端连接所需信息） 说明：客户端连接时通常需要提供一个配置描述，包含服务器名称、启动命令与参数（command、args），以便自动化接入与管理。以下为示意配置（用来帮助理解真实使用场景，非代码实现）： { "serverName": "neuroverse-mcp", "command": "node", "args": ["dist/runtime/mcp-server.js", "--world", "./worlds/configurator_governance_v1", "--plan", "./plans/plan.json", "--trace"], "description": "NeuroVerse 管理的 MCP 服务端，负责对 Claude Cursor 等 MCP 客户端提供治理后的工具执行能力。" } 注释说明：
    • serverName：服务器名称，便于在多服务器环境中标识。
    • command/args：用于启动服务器的命令及参数，包含世界路径、计划路径等必要信息，确保 MCP 客户端能正确连接并进行工具治理。
    • 该配置仅用于 MCP 客户端对接时的描述; 客户端不需要/也不依赖客户端实现中的具体代码。
  • 基本使用方法
    • 启动服务器前，确保世界与计划已编译并可用。
    • 使用支持 MCP 的客户端连接至服务器，按客户端文档进行初始化握手、获取工具列表、发起工具调用等交互。
    • 客户端通过工具调用的 JSON-RPC 路径与参数，将经过治理后的结果返回到模型或执行方。
    • 服务器内部控制工具执行、计划推进、以及对失败/阻塞/暂停的处理流程。

服务器信息

访问项目