AI导哈

YouTube视频元数据服务

一个基于FastAPI的MCP服务器，提供YouTube视频元数据和字幕提取功能，适用于Cursor等MCP客户端。

  • by meh313
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 meh313/youtube-mcp

使用说明

YouTube MCP服务器

基于FastAPI的MCP服务器，为Cursor和其他MCP客户端提供YouTube视频元数据和转录本作为工具。

特性

  • 获取视频标题、描述、作者、发布日期、观看次数、标签和最佳缩略图。
  • 检索英文成绩单，如果英语不可用，则回退到阿拉伯语。
  • 暴露单个 /youtube-info 端点作为MCP工具。
  • 元数据和转录检索的强大错误处理。

需求

  • Python 3.10+
  • 看 pyproject.toml 用于依赖关系（使用FastAPI、yt-dlp、youtube转录api、FastAPI-mcp等）

安装

# Clone the repository
git clone https://github.com/meh313/youtube-mcp.git
cd youtube-mcp

# (Recommended) Create a virtual environment
python -m venv .venv
.venv\Scripts\activate  # On Windows
# or
source .venv/bin/activate  # On Linux/Mac

# Install dependencies
pip install .  # or use 'uv pip install' if you use uv
# Or install directly from pyproject.toml:
# pip install -e .
# or
# uv pip install -e .

用法

uvicorn main:app --reload

然后访问API：

http://localhost:8000/youtube-info?video_id=YOUR_VIDEO_ID

示例请求

GET /youtube-info?video_id=l6TrXxqSzrE

示例响应

{
  "metadata": {
    "title": "Create an AI Chat Bot in n8n in 60 Seconds or Less!",
    "description": "...",
    "author": "Kris Torrington",
    "publish_date": "20250505",
    "length": 91,
    "views": 25,
    "keywords": ["n8n", "AI chatbot", "..."],
    "channel_url": "https://www.youtube.com/channel/UCUevUDRxTDJCoG1KxQveXag",
    "thumbnail": "https://i.ytimg.com/vi/l6TrXxqSzrE/maxresdefault.jpg"
  },
  "transcript": "Hi everyone. I'm going to show you how..."
}

MCP集成

要将此服务器用作Cursor中的工具，请执行以下操作：

  1. 确保服务器正在运行(uvicorn main:app --reload).
  2. 将以下内容添加到您的 .cursor/mcp.json:
    "youtube": {
  "url": "http://localhost:8000/mcp"
}
  3. 重新启动游标。这 /youtube-info 工具将在工具列表中可用。

与其他MCP客户端集成

要将此MCP服务器与任何其他MCP兼容客户端集成，请执行以下操作：

  1. 确保服务器正在运行且可访问（默认值： http://localhost:8000).
  2. 在MCP客户端的配置中，添加一个指向MCP端点的工具条目：
    "youtube": {
  "url": "http://localhost:8000/mcp"
}
    • 替换 localhost 如果远程运行，则使用服务器的地址。
    • 端点 /mcp 为所有MCP客户端公开YouTube信息工具。
  3. 根据需要重新启动或重新加载MCP客户端。YouTube工具现在应该可以使用了。

有关配置外部工具的详细信息，请参阅特定MCP客户端的文档。

许可证

MIT许可证

版权所有（c）2025 meh313

特此免费向任何获得副本的人授予许可 本软件和相关文档文件（“软件”），以处理 在软件中不受限制，包括但不限于权利 使用、复制、修改、合并、发布、分发、再许可和/或销售 软件的副本，并允许软件的接收者 根据以下条件提供：

上述版权声明和本许可声明应包含在所有 软件的副本或实质性部分。

软件按“原样”提供，不提供任何形式的明示或明示担保 隐含的，包括但不限于适销性保证， 适用于特定目的且不造成伤害。在任何情况下 作者或版权持有人对任何索赔、损害赔偿或其他 因以下原因产生的责任，无论是在合同、侵权或其他诉讼中， 出于或与软件、使用或其他交易有关 软件。

相关 MCP