VellaVeto MCP 服务器

关键词

资源管理工具执行Prompts 渲染JSON-RPC审计与合规

使用说明（简明步骤，便于快速上手）

  • 项目简介

    • VellaVeto 的 MCP 服务器实现提供一个标准化后端，用于向 LLM 客户端提供资源访问、工具注册与执行能力，以及可定制的 Prompt 模板渲染。服务器通过 JSON-RPC 与客户端通信，负责会话管理、能力声明与跨传输协议支持，目标是在保持高性能与安全审计的前提下，提供可扩展的上下文服务。

  • 主要功能点

    • 资源管理与数据访问：托管与访问可用的 Resources（如服务器文件、数据源等）。
    • 工具注册与执行：注册外部工具并对调用进行策略评估，允许或拒绝工具调用。
    • Prompt 模板定义与渲染：提供可定制的 Prompt 模板以驱动 LLM 的交互模式。
    • JSON-RPC 通信：遵循 MCP 的请求/响应模型，处理读取资源、调用工具、获取 Prompts 等请求。
    • 会话管理与能力声明：维护会话、能力清单、策略执行以及审计日志。
    • 多传输协议支持：支持 stdio、HTTP、WebSocket 等传输通道，适配多种客户端。
    • 审计与合规：在工具执行与资源访问时产生日志、支持审计追踪与合规证据。

  • 安装步骤

    • 克隆仓库并进入项目根目录。
    • 使用 Rust 构建工具进行编译与打包（Release 版以获得更好性能）。
    • 根据需要选择不同的代理/网关组件（例如纯代理、HTTP 网关、或带证书的代理网关）。

  • 服务器配置（供 MCP 客户端使用的配置示例说明，JSON 字符串仅作描述性信息，具体字段含义在注释中）

    • server_name: 指定 MCP 服务器的名称，用于在 MCP 客户端配置中引用该服务器。
    • command: 启动服务器的可执行程序名，例如 vellaveto-proxy、vellaveto-http-proxy 等。
    • args: 启动参数数组，描述运行模式、保护等级、上游目标等。
    • 注释说明：客户端无需以下信息，但用于 MCP 配置参考，确保与服务器对接一致。
    • 参考配置要点（描述性文本，不是代码片段）：
      • 示例服务器名称：filesystem
      • 启动命令：vellaveto-proxy
      • 启动参数示例（仅描述用途）：
        • --protect shield
        • -- 读取本地文件系统的 MCP 服务，例如 "@modelcontextprotocol/server-filesystem" 与目标目录
    • 说明：实际 MCP 客户端只需知道服务器名称、命令和参数的组合以启动与对接；JSON 配置对 MCP 客户端不可见。

  • 基本使用方法

    • 第一步：在服务端部署并启动 MCP 服务器（如 vellaveto-proxy 或 vellaveto-http-proxy）。
    • 第二步：在 MCP 客户端（如 Claude Desktop、Cursor、Windsurf 等）中将上述 MCP 服务器添加为一个可用的后端上下文源，确保服务可访问。
    • 第三步：通过 MCP 客户端向服务器发起读取资源、调用工具、获取 Prompts 的请求，服务器按 MCP 规范处理并返回 JSON-RPC 响应。
    • 第四步：根据需要启用审计、日志和合规证据导出，确保操作可追溯。

  • 备注

    • MCP 客户端需要的仅是服务器的可访问地址与接口能力，服务器端应实现对请求的解析、策略评估与安全审计。
    • 本实现提供多传输通道的能力，便于在不同场景下接入（本地代理、HTTP网关等）。

服务器信息

访问项目