项目简介

Youtube Summarizer MCP Server 是一个基于 Model Context Protocol (MCP) 构建的应用后端,它将 Youtube Summarizer 项目的API接口以 MCP 工具的形式暴露出来,使得任何兼容 MCP 协议的AI应用,如 Claude Desktop,都能方便地集成和调用这些功能,从而实现与 YouTube 视频内容进行交互。

主要功能点

  • 视频摘要: 允许LLM客户端通过视频ID调用工具来生成YouTube视频的摘要。
  • 获取摘要: 允许LLM客户端通过摘要ID获取已生成的视频摘要的详细信息。
  • 创建聊天: 允许LLM客户端基于视频摘要创建新的聊天会话,以便进行更深入的对话。
  • 获取聊天: 允许LLM客户端通过聊天ID获取特定聊天会话的详细信息。

安装步骤

  1. Docker 安装 (推荐)

    • 确保已安装 Docker 环境。
    • 克隆或下载该仓库代码到本地。
    • 在仓库根目录下,打开终端,执行以下命令构建 Docker 镜像:
      docker build -t youtube-summarizer-mcp .
  2. 使用 Inspector (可选)

    • 如果您想探索可用的工具并进行测试,可以运行 'inspector.sh' 脚本:
      ./inspector.sh

服务器配置

对于 MCP 客户端 (例如 Claude Desktop),您需要配置 MCP 服务器的启动命令和参数,以便客户端能够连接到服务器。以下是针对 Claude Desktop 的 'claude_desktop_config.json' 配置文件示例,您可以参考此示例进行配置:

{
  "mcpServers": {
    "youtube-summarizer": {  // 服务器名称,可以自定义
      "command": "docker",  // 启动服务器的命令,这里使用 Docker
      "args": [          // 命令参数
        "run",         // Docker run 命令
        "-i",          // 保持STDIN打开,即使没有连接
        "--rm",        // 容器退出时自动删除容器
        "youtube-summarizer-mcp" // Docker 镜像名称,与构建时指定的名称一致
      ]
    }
  }
}

配置说明:

  • '"youtube-summarizer"': 是您为该 MCP 服务器自定义的名称,在 Claude Desktop 中用于标识和使用该服务器。
  • '"command": "docker"': 指定了启动 MCP 服务器的命令为 'docker',表明服务器将以 Docker 容器的方式运行。
  • '"args": [...]"': 提供了 'docker run' 命令的参数,这些参数确保了 Docker 容器能够以后台交互模式运行,并在容器停止后自动清理。'youtube-summarizer-mcp' 是之前构建的 Docker 镜像的名称。

基本使用方法

  1. 启动 MCP 服务器

    • 如果您使用 Docker 安装,只需确保 Docker 已经启动,Claude Desktop 将根据配置自动启动服务器。
    • 如果您不使用 Claude Desktop,可以使用以下 Docker 命令手动运行服务器:
    docker run -i --rm youtube-summarizer-mcp
  2. 在 MCP 客户端中使用工具

    • 以 Claude Desktop 为例,配置完成后,您就可以在 Claude 中使用 'youtube-summarizer' 服务器提供的工具了。Claude Desktop 会自动发现并列出这些工具,您可以像调用普通函数一样在对话中使用它们,例如,您可以让 Claude "总结一下这个YouTube视频 [视频ID]",Claude 就会调用 'summarize_video' 工具来完成任务。
  3. 运行 MCP 客户端示例 (不使用 Claude Desktop)

    • 如果您想体验不依赖 Claude Desktop 的 MCP 客户端,可以按照 'README.md' 中的 "MCP Client Sample (Without Claude Desktop)" 部分的指引操作:
    ./setup.sh   # 安装客户端依赖
    ./run.sh     # 运行 MCP 服务器和客户端
    • 运行 'run.sh' 后,终端会提示您输入自然语言查询,客户端会将查询转换为 MCP 工具调用,并展示结果。

通过以上步骤,您就可以成功搭建并使用 Youtube Summarizer MCP Server,并将其集成到兼容 MCP 协议的 LLM 应用中,从而扩展 LLM 的能力,使其能够理解和处理 YouTube 视频内容。

信息

分类

AI与计算