Youtube MCP 服务器

• Youtube MCP 服务器
  • 关于
  • 什么是 MCP？
  • 这个服务器做什么？
  • 实际用例
  • 先决条件
  • 安装
  • 配置
    • Claude Desktop 配置
  • 开发
    • 开始
    • 在 Inspector 中调试服务器
  • 故障排除
    • 消息 '无法连接到 MCP 服务器 mcp-youtube'

关于

该服务器是 YouTube API 和 AI 助手之间的桥梁，基于 Model Context Protocol。

什么是 MCP？

Model Context Protocol (MCP) 是一个系统，允许像 Claude Desktop 这样的 AI 应用程序连接到外部工具和数据源。它为 AI 助手提供了与本地服务和 API 清晰且安全的工作方式，同时保持用户控制。

这个服务器做什么？

• 下载给定视频的字幕

实际用例

• 创建视频摘要

先决条件

• uv 工具

安装

uv tool install git+https://github.com/sparfenyuk/mcp-youtube

[!NOTE]
如果您已经安装了服务器，可以使用 uv tool upgrade --reinstall 命令进行更新。

[!NOTE]
如果要删除服务器，请使用 uv tool uninstall mcp-youtube 命令。

配置

Claude Desktop 配置

配置 Claude Desktop 以识别 YouTube MCP 服务器。

1. 打开 Claude Desktop 配置文件：

   • 在 MacOS 上，配置文件位于 ~/Library/Application Support/Claude/claude_desktop_config.json
   • 在 Windows 上，配置文件位于 %APPDATA%\Claude\claude_desktop_config.json

   注意:
   您也可以在 Claude Desktop 应用程序的设置中找到 claude_desktop_config.json 文件

2. 添加服务器配置

   {
     "mcpServers": {
       "mcp-youtube": {
           "command": "mcp-youtube",
         }
       }
     }
   }
   

开发

开始

1. 克隆仓库

2. 安装依赖项

   uv sync
   

3. 运行服务器

   uv run mcp-youtube --help
   

工具可以添加到 src/mcp_youtube/tools.py 文件中。

如何添加新工具：

1. 创建一个新的类，继承自 ToolArgs

   class NewTool(ToolArgs):
       """新工具的描述。"""
       pass
   

   类的属性将用作工具的参数。
   类的文档字符串将用作工具的描述。

2. 为新类实现 tool_runner 函数

   @tool_runner.register
   async def new_tool(args: NewTool) -> t.Sequence[TextContent | ImageContent | EmbeddedResource]:
       pass
   

   该函数应返回 TextContent、ImageContent 或 EmbeddedResource 的序列。
   该函数应该是异步的，并接受一个新类的单个参数。

3. 完成！重启客户端后，新的工具应该可用。

验证可以通过 Claude Desktop 或直接运行工具来完成。

在 Inspector 中调试服务器

MCP 检查器是一个使用高级用户界面帮助调试服务器的工具。要运行它，请使用以下命令：

npx @modelcontextprotocol/inspector uv run mcp-youtube

故障排除

消息 '无法连接到 MCP 服务器 mcp-youtube'

如果在 Claude Desktop 中看到消息 '无法连接到 MCP 服务器 mcp-youtube'，则表示服务器配置不正确。

请尝试以下操作：

• 在配置文件中使用 mcp-youtube 二进制文件的完整路径