yt-mcp-server

Name: yt-mcp-server
Author: kdr

本地服务

github.com/kdr社交媒体378 周前更新

代码仓库

关于 yt-mcp-server

yt-mcp-server 是一个处理 YouTube 数据的 MCP 服务，提供视频 URL、视频 ID 和缩略图相关工具。它适合需要规范化 YouTube 链接或生成视频地址的 MCP 客户端。

主要功能

01规范化 YouTube URL
02从 URL 提取视频 ID
03生成视频播放地址
04生成视频缩略图地址
05支持设置播放起始时间

适用场景

01将不同格式的 YouTube 链接转换为标准地址
02根据视频 ID 构造播放链接
03获取视频缩略图 URL

MCP 相关

该 MCP 服务向客户端提供 YouTube URL 规范化、播放地址和缩略图地址工具。

#yt-mcp-server #youtube-data #utility-functions

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "yt-mcp-server-kdr": {
      "command": "uvx",
      "args": [
        "git+https://github.com/kdr/yt-mcp-server.git"
      ]
    }
  }
}

启动命令uvx 'git+https://github.com/kdr/yt-mcp-server.git'

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

pypigit+https://github.com/kdr/yt-mcp-server.gitstdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

yt-mcp-server

一个 MCP 服务，提供各种用于处理 YouTube 数据的实用功能。此服务提供了用于处理 YouTube URL、视频 ID 和缩略图的工具。

📖 资源

模型上下文协议

先决条件

Python 3.12 或更高版本
UV 包管理器

设置

1. 安装 UV

如果尚未安装 UV，可以使用以下方式安装：

brew install uv
# alternatively curl -LsSf https://astral.sh/uv/install.sh | sh

2. 安装方法

方法 1：从 GitHub 安装（推荐）

这是安装和运行该服务最简单的方式：

uvx --from git+https://github.com/kdr/yt-mcp-server.git server

方法 2：本地开发设置

如果要在本地修改代码：

git clone https://github.com/kdr/yt-mcp-server.git
cd yt-mcp-server
uv venv
source .venv/bin/activate  # On Unix/macOS
# or
.venv\Scripts\activate  # On Windows
uv pip install -e .

3. 配置 MCP 客户端

将以下配置添加到 MCP 客户端设置中：

{
    "mcpServers": {
        "yt-mcp-server": {
            "command": "uvx",
            "args": [
                "--from",
                "git+https://github.com/kdr/yt-mcp-server.git",
                "server"
            ]
        }
    }
}

对于本地开发（方法 2），请改用以下配置：

{
    "mcpServers": {
        "yt-mcp-server": {
            "command": "uv",
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/PARENT/FOLDER/yt-mcp-server/yt_mcp_server",
                "run",
                "main.py"
            ]
        }
    }
}

可用工具

大模型可以使用以下工具：

get_watch_url：返回给定视频 ID 对应的 YouTube 观看 URL，可选择从特定时间开始播放
- 参数：
  - video_id：YouTube 视频 ID
  - start_time：（可选）开始时间，单位为秒
get_thumbnail_url：返回给定 YouTube 视频 ID 对应的缩略图 URL
- 参数：
  - video_id：YouTube 视频 ID
get_normalized_url：将各种 YouTube URL 格式规范化为标准观看 URL，并提取视频 ID
- 参数：
  - url：要规范化的 YouTube URL