使用说明

项目简介

DeepSRT MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器应用,它通过与 DeepSRT API 集成,为大型语言模型 (LLM) 客户端提供 YouTube 视频的摘要生成功能。该服务器允许 LLM 应用通过标准化的 MCP 协议调用工具,获取指定 YouTube 视频的精炼摘要,从而增强 LLM 在视频内容理解和处理方面的能力。

主要功能点

  • YouTube 视频摘要生成: 能够根据用户提供的 YouTube 视频 ID,生成视频内容的文本摘要。
  • 多语言支持: 支持生成多种语言的视频摘要,默认语言为繁体中文。
  • 摘要模式选择: 支持生成叙述式 (narrative) 和要点式 (bullet-point) 两种摘要模式,满足不同场景的需求。
  • MCP 协议兼容: 完全遵循 Model Context Protocol 协议,可以与任何兼容 MCP 协议的 LLM 客户端(如 Claude Desktop, Cline)无缝集成。

安装步骤

  1. 构建服务器: 首先需要构建服务器端代码。请确保已安装 Node.js 和 npm。在仓库根目录下,执行以下命令:

    npm install
    npm run build

    构建成功后,会在项目根目录下生成 'build' 目录,其中包含编译后的服务器代码 'index.js' 文件。

  2. 配置 MCP 客户端: 根据你使用的 MCP 客户端类型,选择相应的配置方式。

    • Claude Desktop 配置:

      • 打开 Claude Desktop 的配置文件 'claude_desktop_config.json'。
        • macOS: '~/Library/Application Support/Claude/claude_desktop_config.json'
        • Windows: '%APPDATA%/Claude/claude_desktop_config.json'
      • 在 'mcpServers' 字段下添加 'deepsrt-mcp' 服务器的配置信息。请将 '/path/to/deepsrt-mcp/build/index.js' 替换为实际的 'index.js' 文件路径。
      {
        "mcpServers": {
          "deepsrt-mcp": {
            "command": "node",
            "args": [
              "/path/to/deepsrt-mcp/build/index.js"
            ]
          }
        }
      }
    • Cline 配置:

      • 如果使用 Cline,则无需手动配置。在 Cline 聊天界面中,直接发送安装命令即可:
      Hey, install this MCP server for me from https://github.com/DeepSRT/deepsrt-mcp

      Cline 会自动完成安装和配置。

服务器配置

对于 MCP 客户端,你需要配置以下信息以连接到 DeepSRT MCP Server。这些配置通常在客户端的配置文件中进行设置,例如 Claude Desktop 的 'claude_desktop_config.json' 或 Cline 的 'cline_mcp_settings.json'。

{
  "server name": "deepsrt-mcp",
  "command": "node",
  "args": [
    "/path/to/deepsrt-mcp/build/index.js"
  ]
}

配置参数说明:

  • 'server name': 服务器的名称,客户端使用此名称来识别和调用该服务器,例如 "deepsrt-mcp"。
  • 'command': 启动服务器的命令,这里是 'node',表示使用 Node.js 运行时环境。
  • 'args': 传递给 'command' 的参数列表。这里指定了服务器入口文件 'index.js' 的路径。请根据实际部署环境修改为正确的 'index.js' 文件路径。

基本使用方法

客户端 (如 Claude Desktop, Cline) 通过 MCP 协议调用 'get_summary' 工具来获取 YouTube 视频摘要。以下是使用示例:

在 Claude Desktop 中使用:

const result = await mcp.use_tool("deepsrt-mcp", "get_summary", {
  videoId: "dQw4w9WgXcQ",
  lang: "zh-tw",
  mode: "narrative"
});
console.log(result);

在 Cline 中使用:

const result = await mcp.use_tool("deepsrt", "get_summary", {
  videoId: "dQw4w9WgXcQ",
  lang: "zh-tw",
  mode: "bullet"
});
console.log(result);
  • 'mcp.use_tool()' 是 MCP 客户端提供的调用工具的函数。
  • 第一个参数是服务器名称 ('"deepsrt-mcp"' 或 '"deepsrt"'),需要与你在客户端配置中设置的名称一致。
  • 第二个参数是工具名称,DeepSRT MCP Server 提供的工具是 '"get_summary"'。
  • 第三个参数是工具的参数,以 JSON 对象形式传递,包括:
    • 'videoId' (必选): YouTube 视频的 ID。
    • 'lang' (可选): 摘要的语言代码,默认为 '"zh-tw"' (繁体中文)。
    • 'mode' (可选): 摘要模式,可选值为 '"narrative"' (叙述式) 或 '"bullet"' (要点式),默认为 '"narrative"'。

工具调用成功后,'result' 变量将包含视频摘要的文本内容。请注意,首次请求某些视频的摘要时,可能会因为 DeepSRT CDN 缓存未命中而返回 404 错误。请先通过 DeepSRT Chrome 扩展打开视频以进行缓存,然后再尝试通过 MCP 服务器获取摘要。

信息

分类

AI与计算