YouTube MCP 服务器

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

关于

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

<a href="https://glama.ai/mcp/servers/gzrh7914k6"> <img width="380" height="200" src="https://gips0.baidu.com/it/u=3899348819,1655242946&fm=3081&app=3081&f=PNG?w=760&h=400" alt="YouTube 服务器 MCP 服务器" /> </a>

什么是MCP？

模型上下文协议（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 Inspector 是一个帮助通过漂亮的UI调试服务器的工具。要运行它，请使用以下命令：

npx @modelcontextprotocol/inspector uv run mcp-youtube

故障排除

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

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

尝试以下操作：

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