VideoRLM KUAVi MCP 服务器

关键词

视频分析工具集成会话管理资源访问服务器端

使用说明（Markdown）

  • 项目简介

    • 该仓库实现了一个可运行的 MCP 服务器，作为 LLM 客户端获取上下文、调用外部工具和获取提示模板的后端。核心组件围绕 KUAVi 的视频分析能力与 MCP 协议展开，提供多达若干工具（Tools）与 1) 资源/索引访问、2) 外部功能调用、3) 提示模板渲染等能力，用于在 LLM 与视频分析流程之间创建一个标准化的后端服务层。
    • 服务器端实现了对 MCP 请求的处理、工具路由、会话与预算管控，以及对多种传输的支持（如标准输入输出、SSE、WebSocket 等传输场景的扩展能力），从而为 LLM 应用提供安全、可扩展的上下文服务框架。

  • 主要功能点

    • MCP 核心能力:
      • 资源(Resource)管理：提供对视频索引、嵌入向量、Transcript 等资源的访问接口。
      • 工具(Tools)注册与执行：暴露 30+ MCP 工具集，支持并发、缓存、以及结果的统一封装，便于 LLM 调用外部功能。
      • 提示模板(Prompts)：提供可渲染的提示模板与上下文注入，便于 LLM 以一致方式解析上下文信息。
    • 会话与能力声明：服务器端维护会话上下文、状态、以及对能力的声明，便于客户端了解可用的工具与资源。
    • 多传输协议扩展：实现了基于标准输入输出的 FastMCP 形式的工具服务器，后续可扩展到 SSE/WebSocket 等传输。
    • 安全性与扩展性：集中管理工具调用、预算控制、以及日志追踪，便于审计和追踪推理过程。

  • 安装步骤

      1. 克隆仓库并进入项目根目录。
      1. 安装依赖（示例命令，不给出具体代码块，仅描述性指引）：
      • 使用常见的 Python 环境管理工具创建虚拟环境并安装依赖（如 pip install -r requirements.txt，若提供了 requirements 文件则执行之）。
      1. 启动 MCP 服务器（以 stdio 传输为例）：
      • 通过运行对应的入口，启动 kuavi.mcp_server 模块，使服务器开始监听并响应 MCP 客户端的请求。
      1. 根据需要，将 MCP 服务器注册到客户端配置中（如 Claude Code 客户端），以实现与 MCP 的对接。

  • 服务器配置（MCP 客户端无需修改服务器端，仅供 MCP 客户端接入参考）

    • 服务器名称（server name）：VideoRLM KUAVi
    • 启动命令（command）：uv
    • 启动参数（args）：["run", "python", "-m", "kuavi.mcp_server"]
    • 配置示例（JSON，供 MCP 客户端参考，不作为代码块呈现）： { "mcpServers": { "videorLM-kuavi": { "name": "VideoRLM KUAVi MCP Server", "command": "uv", "args": ["run", "python", "-m", "kuavi.mcp_server"] } } }
    • 说明：上述配置用于 MCP 客户端在启动时从配置中获取服务器信息，以建立与 MCP 服务器的连接（客户端配置通常包含 server name、command、args 等信息，便于自动化接入和部署）。

  • 基本使用方法

    • 启动与连接
      • 启动 MCP 服务器后，MCP 客户端会通过预定义的传输通道（如 stdio）向服务器发送 MCP 请求，服务器返回标准化的 JSON-RPC 响应或通知。
    • 调用工具与资源
      • 客户端可以通过 MCP 请求读取资源、注册并执行工具、获取并渲染 Prompt 模板等。
    • 会话与预算
      • 服务器维护会话状态，并对工具调用及资源访问进行预算控制与追踪，确保长时间推理过程的可控性与可观测性。
    • 监控与日志
      • 服务端会记录调用轨迹、工具调用、LLM 调用与推理过程，便于诊断与可视化分析。

  • 注意

    • 本实现包含服务器端逻辑（kuavi.mcp_server 等模块）及其对外暴露的 MCP 工具集合，确保不是仅有客户端示例或测试用例。具体的工具实现、路由、以及服务器的状态管理在仓库中有完整实现与单元测试覆盖。
    • 配置与使用时，请确保在生产环境中对 API、密钥、资源访问进行妥善保护与权限控制，并遵循相关模型提供方的使用政策。

  • 关键词 视频分析, 工具集成, 会话管理, 资源访问, 服务器端 MCP

  • 分类 6

服务器信息

访问项目