本项目是 CloudGlue 平台的 Model Context Protocol (MCP) 服务器实现，允许将 CloudGlue 的视频处理、分析和管理能力通过标准化的 MCP 协议暴露给兼容的 AI 助手（如 Cursor, Claude Desktop 等）。

主要功能点：

• 视频内容理解与分析： 提供工具用于获取 CloudGlue 中上传视频或 YouTube 视频的详细描述和提取特定实体信息。
• 视频和集合管理： 提供工具用于列出用户账号下的视频文件和视频集合，获取特定视频或集合中视频的详细信息。
• 视频集合问答： 支持对整个视频集合进行问答，利用 CloudGlue 的能力从视频内容中检索信息并生成回复。
• 集成到 AI 工作流： 使 AI 助手能够理解用户提及的视频或视频集合，并自动调用相应的工具来获取上下文信息或执行任务。

安装步骤：

1. 获取 CloudGlue API Key： 前往 CloudGlue 官网 cloudglue.dev 获取您的 API Key。
2. 安装服务器： 您可以使用 npx 直接运行最新版本，或者克隆仓库并在本地构建。
   • 使用 npx (推荐)：确保您已安装 Node.js 和 npm/npx。
   • 本地构建：克隆仓库，运行 'npm install' 安装依赖，然后运行 'npm run build' 进行构建。

服务器配置（在您的 AI 客户端中）：

MCP 服务器通常由 AI 客户端启动和管理。您需要在 AI 客户端的配置中添加一个 MCP 服务器条目，指定如何启动 CloudGlue MCP 服务器。配置通常是一个 JSON 结构，您需要提供服务器的名称、启动命令及其参数。

• 服务器名称： 您可以自定义一个名称，例如 'cloudglue' 或 'cloudglue-mcp-server'。
• 启动命令 (command)： 指定如何运行服务器。
  • 如果使用 npx 安装：'npx'
  • 如果本地构建：'node' 加上构建后主文件的绝对路径，例如 '/path/to/cloudglue-mcp-server/build/index.js'。
• 参数 (args)： 提供启动命令所需的参数，特别是您的 CloudGlue API Key。
  • 如果使用 npx 安装：'["-y", "@aviaryhq/cloudglue-mcp-server@latest"]'，并在客户端配置的环境变量中添加 'CLOUDGLUE_API_KEY=<YOUR-API-KEY>'。
  • 如果本地构建：提供主文件路径，然后通过 '--api-key <YOUR-API-KEY>' 参数传递 API Key，例如 '["/path/to/cloudglue-mcp-server/build/index.js", "--api-key", "<YOUR-API-KEY>"]'。

将 '<YOUR-API-KEY>' 替换为您在步骤 1 中获取的真实 API Key。具体配置方式请参考您使用的 AI 客户端的文档。

基本使用方法：

配置完成后，重启您的 AI 客户端。客户端会自动发现并连接到 CloudGlue MCP 服务器，并了解其提供的工具能力。当您与 AI 交互时，如果您的对话或任务涉及到视频（例如询问某个视频的内容、查找某个视频集合中的信息），AI 助手会识别出可以使用 CloudGlue MCP 服务器提供的工具来完成任务，并自动调用相应的工具与服务器进行通信，获取或处理视频数据，从而提供更丰富、更准确的回答或执行更复杂的操作。