VellaVeto MCP 服务器

关键词

Model Context ProtocolJSON-RPC资源管理工具注册与执行审计与合规

使用说明（Markdown 格式）

  • 项目简介

    • VellaVeto MCP 服务器是一个完整的 MCP 服务器实现，核心职责是向 LLM 客户端提供标准化的上下文信息与功能，包括对资源的访问、工具的注册与执行，以及提示模板的定义与渲染。它还实现策略引擎、可审计的操作日志和多传输协议支持，旨在为代理/LLM 应用提供安全、可追溯的上下文服务。

  • 主要功能点

    • MCP 核心通信：实现基于 JSON-RPC 的请求与响应处理，支持资源读取、工具调用、任务/弹性请求等 MCP 请求类型。
    • 资源与工具管理：托管和管理资源与工具的元数据，支持对外部服务的访问能力声明与执行。
    • Prompt 与模板：提供提示模板的注册、渲染与调度，便于灵活定义 LLM 的对话模式。
    • 安全与审计：内置策略引擎、威胁检测、审计日志（支持 tamper-evident 日志链路）、以及多种安全机制（如访问控制、DLP、ABAC 等）。
    • 会话与能力声明：对会话进行管理、能力（资源、工具、Prompts）的声明与发布，支持多租户。
    • 部署模式与传输协议：支持多传输模式（如 stdio、HTTP gateway、WebSocket 等）以及网关/反向代理组合。

  • 安装步骤

    • 准备工作：需要安装 Rust 编译器与 Cargo，推荐使用与仓库 MSRV 一致的版本（如 1.88.0 及以上）。
    • 获取代码：将仓库克隆到本地，进入 vellaveto-mcp 相关工作区。
    • 编译与构建：在仓库根目录执行构建命令以生成可执行的 MCP 服务器二进制文件（具体二进制名称取决于构建产物配置，通常为 vellaveto 相关的 serve / server 命令组合）。
    • 运行服务：使用生成的二进制启动 MCP 服务器（示例： vellaveto serve 或 vellaveto-mcp-server，取决于构建产物命名），并按需要提供配置文件。

  • 服务器配置（MCP 客户端需要的配置示例）

    • server_name: vellaveto-mcp
    • command: vellaveto
    • args: ["serve", "--config", "/path/to/mcp/config.toml"] 配置说明：该配置用于 MCP 客户端在启动时连接到 MCP 服务器。server_name 用于标识服务器实例，command 为启动服务器所用的可执行程序名称，args 为启动参数。在实际使用中，请将 /path/to/mcp/config.toml 替换为真实的服务器配置文件路径。客户端仅需启动命令与参数来连接 MCP 服务器，无需额外的客户端端点变更。

  • 基本使用方法

    • 启动服务器：以上述配置启动 MCP 服务器二进制，确保配置文件（如 policy.toml、mcp 配置等）就绪。
    • 客户端连接：使用 Claude Desktop、Cursor、Windsurf 等工具将 MCP 客户端指向该服务器（通过网络或本地 stdio 等传输模式）。客户端配置只需指定服务器启动命令与参数即可建立连接。
    • 发送与处理请求：客户端通过 MCP 的 JSON-RPC 机制发送读取资源、请求工具、获取 Prompts 等请求，服务器处理并返回 JSON-RPC 响应。
    • 监控与扩展：如需扩展能力（新增资源、工具、策略等），可通过修改配置并重启服务器，或接入现有的多租户控制平面能力。

  • 备注

    • 该实现包含服务器端核心模块、策略引擎、审计与合规、以及各种工具与上下文管理组件，属于完整的 MCP 服务器实现而非单纯示例。

服务器信息

访问项目