AI导哈

YouTube评论MCP服务器

一个遵循Model Context Protocol (MCP)的本地服务器，用于获取和展开YouTube视频的顶層留言及回复，返回JSON格式数据。

  • by 878787ya
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 878787ya/yt_mcp

使用说明

yt_mcp — YouTube Comments MCP Server

一個遵循 Model Context Protocol (MCP) 的本機伺服器。提供工具：

  • fetch_comments(videoUrl, order="relevance|time", max=300) 以 YouTube Data API v3 取得並展開 頂層留言＋回覆，回傳 JSON 字串。

需求

  • Python 3.10+
  • 已啟用 YouTube Data API v3 的 API 金鑰

安裝

uv venv
source .venv/bin/activate
uv pip install "mcp[cli]" httpx python-dotenv

設定金鑰（擇一）

A. 用 .env（推薦）

在專案根目錄建立 .env：

YOUTUBE_API_KEY=YOUR_API_KEY_HERE

B. 寫在客戶端設定的 env（見下方範例）

在 Claude Desktop 使用（本機 STDIO）

  1. 開啟：Settings → Developer → Local MCP servers → Edit Config
  2. 加入（請把絕對路徑換成你的實際路徑）：
{
  "mcpServers": {
    "yt_comments": {
      "command": "<abs path>/yt_mcp/.venv/bin/python",
      "args": ["<abs path>/yt_mcp/server.py"],
      "env": { "YOUTUBE_API_KEY": "YOUR_API_KEY" }  // 若已用 .env，可移除此段
    }
  }
}

也可不填 env，改用專案根目錄的 .env。

  1. 回到 Local MCP servers 啟動 yt_comments。
  2. 新開對話請 Claude 呼叫：
yt_comments.fetch_comments(
  videoUrl="https://www.youtube.com/watch?v=XXXXXXXXXXX",
  order="relevance",
  max=300
)

接著請模型做摘要／分類／翻譯並輸出報告。

在 MCP Inspector 測試

  • Transport：STDIO
  • Command：<abs path>/yt_mcp/.venv/bin/python
  • Arguments：<abs path>/yt_mcp/server.py
  • Environment（可選）：YOUTUBE_API_KEY=YOUR_API_KEY

輸出格式（節選）

{
  "video_id": "abcdEFGhijk",
  "order": "relevance",
  "requested": 300,
  "total_returned": 278,
  "items": [
    {
      "id": "...",
      "parentId": null,
      "author": "Somebody",
      "publishedAt": "2025-01-01T12:34:56Z",
      "likeCount": 42,
      "text": "Great video!"
    }
  ]
}

Troubleshooting

  • Missing YOUTUBE_API_KEY 在 .env 或設定的 env 補上金鑰，並確認金鑰已啟用 YouTube Data API v3。
  • 找不到 server.py 在設定裡把 args 改用絕對路徑（例如 "/Users/you/yt_mcp/server.py"）。
  • ModuleNotFoundError 確認已在虛擬環境內安裝相依套件（"mcp[cli]" httpx python-dotenv）。
  • HTTP 403/400 可能是配額不足、影片關閉留言、或金鑰權限未開。

安全

  • .env 已在 .gitignore 中，請勿提交金鑰。
  • 若曾不小心提交金鑰，請 旋轉金鑰 並清理 Git 歷史。

授權

MIT License。

相关 MCP