Youtube MCP Server

Youtube MCP 服务器

• Youtube MCP 服务器
  • 关于
  • 什么是 MCP？
  • 这个服务器是做什么的？
  • 实际用例
  • 先决条件
  • 安装
  • 配置
    • Claude桌面配置
  • 发展
    • 入门
    • 在检查器中调试服务器
  • 故障排除
    • 消息“无法连接到 MCP 服务器 mcp-youtube”

关于

该服务器是 Youtube API 和 AI 助手之间的桥梁，基于模型上下文协议。

什么是 MCP？

模型上下文协议 (MCP) 是一个允许 AI 应用（例如 Claude Desktop）连接到外部工具和数据源的系统。它为 AI 助手提供了一种清晰、安全的方式，使其能够使用本地服务和 API，同时保持用户的控制权。

这个服务器是做什么的？

• [x] 下载指定视频的隐藏字幕

实际用例

• [x] 创建视频摘要

先决条件

• uv工具

安装

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

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

配置

Claude桌面配置

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

1. 打开Claude桌面配置文件：
   • 在 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): """Description of the new tool.""" 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 或直接运行工具来完成。

在检查器中调试服务器

MCP 检查器是一款使用精美 UI 帮助调试服务器的工具。要运行它，请使用以下命令：

故障排除

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

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

请尝试以下操作：

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