claudetube MCP 服务器
使用说明
- 项目简介
- claudetube 旨在作为一个 MCP 服务器，把视频下载、转录、视觉分析、场景分割等能力对接到 LLM 客户端。它通过 MCP 标准暴露资源、工具和 Prompts，LLM 客户端可以通过 JSON-RPC 调用相关能力，获取上下文信息并执行外部功能。该实现支持多传输协议、会话管理以及能力声明，方便在 Claude、Gemini 等大语言模型平台中集成视频理解能力。
- 主要功能点
- 资源管理与访问：提供视频元数据、转录文本、帧、场景等资源的读取与缓存能力，方便后续分析。
- 工具注册与执行：提供若干工具接口，LLM 客户端可通过 MCP 调用来完成视频处理、帧提取、场景分析等任务。
- Prompt 模板与渲染：定义并渲染交互所需的提示模板，支持可定制化的对话流程与上下文渲染。
- JSON-RPC 通信与会话管理：服务器端实现标准的 JSON-RPC 请求/响应处理，管理会话状态、能力声明以及对外暴露的接口。
- 多传输协议支持：设计初衷支持 stdio、SSE、WebSocket 等传输方式，方便嵌入到多种环境中使用。
- 安装步骤
-
- 克隆代码并进入仓库目录。
-
- 安装依赖并选择安装方式：
- 使用开发模式安装并启用 MCP 扩展：安装包时包含 mcp 扩展，确保后续 MCP 客户端能够发现 40+ 工具、Prompts 等。
- 或从源码直接运行，确保系统已安装 Python3.10+、FFmpeg、yt-dlp 等运行时依赖。
-
- 启动 MCP 服务器进程（示例名称，实际执行名可能与安装方式相关）：
- 一个常见的启动方式是直接运行服务器进程，例如 claudetube-mcp（若通过包安装会生成该可执行脚本）。
-
- 在目标的 MCP 客户端中注册服务器：
- Claude Code 等客户端通常通过 mcp 配置文件注册你的 MCP 服务器，例如将服务器以 stdio 传输方式添加到客户端配置中，确保客户端能够通过约定的 JSON-RPC 通道与服务器交互。
-
- 服务器配置（MCP 客户端所需，配置为 JSON 格式）
说明：下列配置是用来让 MCP 客户端知道如何启动与连接到你的 MCP 服务器的示例。实际字段名称可能因客户端实现略有不同，但核心信息应包含服务器名称、启动命令及参数等。
- server name: claudetube
- command: claudetube-mcp
- args: [] // 如有自定义参数可在此添加 参考示例（JSON 结构，不作为代码执行块，仅作配置示意）： { "server_name": "claudetube", "command": "claudetube-mcp", "args": [] } 注释说明
- server_name 是你在 MCP 客户端侧用于标识该服务器的名称。
- command 指向启动 MCP 服务的可执行程序或脚本名。
- args 是传递给启动命令的额外参数，必要时可用于设置工作目录、配置路径、日志级别等。
- 基本使用方法
- 启动与注册
- 启动 MCP 服务器进程，使其对外提供资源、工具与 Prompts 的 MCP 接口。
- 在 MCP 客户端中注册该服务器，确保客户端能够通过 JSON-RPC 与之通信。
- 典型交互
- 通过 MCP 客户端请求读取资源（如视频转录、帧数据、场景信息等）。
- 调用工具以执行外部功能（如下载视频、转录、视觉分析、嵌入、摘要等）。
- 获取并渲染 Prompt 模板，按需组合上下文，以便 LLM 进行推理、回答或生成。
- 安全与扩展
- 服务器端负责会话管理和能力声明，支持多用户/多会话场景。
- 通过插件化提供 40+ 工具，按需扩展能力集合，确保与不同 LLM 的兼容性。
- 启动与注册