使用说明

项目简介

VideoDB Agent Toolkit MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器实现，旨在为大型语言模型（LLM）驱动的智能体提供 VideoDB 视频数据库的上下文信息和功能调用能力。通过 MCP 协议，该服务器可以向 LLM 客户端提供关于 VideoDB SDK 的文档和代码示例，并允许 LLM 调用 VideoDB Director API 执行各种视频处理任务，从而简化基于视频内容的 AI 应用开发。

主要功能点

资源 (Resources) 管理:
- 'doc_assistant' 资源: 提供 VideoDB 文档的上下文信息，帮助 LLM 理解 VideoDB 的功能和使用方法。
- 'code_assistant' 资源: 提供 VideoDB SDK 的上下文信息，包括类、方法和使用示例，辅助 LLM 生成与 VideoDB 交互的代码。
工具 (Tools) 注册与执行:
- 'doc_assistant' 工具: 功能与 'doc_assistant' 资源相同，以工具的形式提供文档上下文。
- 'code_assistant' 工具: 功能与 'code_assistant' 资源相同，以工具的形式提供 SDK 上下文。
- 'play_video' 工具: 允许 LLM 控制在浏览器中播放指定链接的视频，方便用户查看视频内容。
- 'call_director' 工具: 核心工具，允许 LLM 调用 VideoDB Director API，执行各种视频处理和分析任务，例如视频上传、下载、索引、搜索、摘要、字幕、配音、生成、编辑、转录等。该工具支持会话管理，允许 LLM 进行多轮对话以完成复杂的视频处理任务。
标准 MCP 协议: 采用 JSON-RPC over Stdio 协议与 MCP 客户端通信，确保与各种 MCP 客户端的兼容性。

安装步骤

确保已安装 Python 和 pip。

执行以下命令安装 'videodb-director-mcp' 包：

pip install videodb-director-mcp

服务器配置

对于 MCP 客户端，需要配置以下 JSON 格式的服务器信息以连接 VideoDB Agent Toolkit MCP Server：

{
  "serverName": "videodb-director-mcp",
  "command": "videodb-director-mcp",
  "args": ["--api-key", "<YOUR_VIDEODB_API_KEY>"]
}

参数说明：

'serverName': 服务器名称，可以自定义，例如 "videodb-mcp-server"。
'command': 启动 MCP 服务器的命令，这里是 'videodb-director-mcp'。
'args': 启动命令的参数列表。
- '--api-key': 必填参数，用于 VideoDB Director API 鉴权的 API 密钥。请替换 '<YOUR_VIDEODB_API_KEY>' 为您在 VideoDB 平台申请的 API 密钥。

请务必将 '<YOUR_VIDEODB_API_KEY>' 替换为您真实的 VideoDB API 密钥，否则 'call_director' 工具将无法正常工作。

基本使用方法

启动 MCP 服务器: 在安装了 'videodb-director-mcp' 的环境中，打开终端并执行以下命令，启动 MCP 服务器：
```
videodb-director-mcp --api-key=<YOUR_VIDEODB_API_KEY>
```
同样，请将 '<YOUR_VIDEODB_API_KEY>' 替换为您的 API 密钥。
配置 MCP 客户端: 在您的 MCP 客户端应用中，根据上述 “服务器配置” 部分的 JSON 配置信息，添加并配置 VideoDB Agent Toolkit MCP Server。
使用资源和工具: MCP 客户端成功连接服务器后，即可向服务器发送 MCP 请求，调用 'doc_assistant'、'code_assistant' 资源和 'play_video'、'call_director' 工具。例如，在需要 VideoDB SDK 上下文时，调用 'code_assistant' 工具；需要执行视频处理任务时，调用 'call_director' 工具并提供自然语言指令。

通过 VideoDB Agent Toolkit MCP Server，LLM 应用可以方便地获取 VideoDB 的相关知识，并利用 VideoDB 强大的视频处理能力，实现更加智能和强大的视频应用。

关键词