Youtube Transcript Downloader

🚀 YouTube MCP 服務器

YouTube MCP 服務器是 YouTube API 和 AI 助手之間的橋樑，基於模型上下文協議，可實現下載視頻閉合字幕、創建視頻摘要等功能。

🚀 快速開始

YouTube MCP 服務器基於模型上下文協議，作為 YouTube API 和 AI 助手之間的橋樑發揮作用。以下是快速體驗該服務器功能的步驟：

1. 確保滿足先決條件，安裝好uv 工具。
2. 執行安裝命令 uv tool install git+https://github.com/sparfenyuk/mcp-youtube。
3. 按照配置步驟對 Claude Desktop 進行配置，使其能識別該服務器。

✨ 主要特性

• 下載閉合字幕：可以下載給定視頻的閉合字幕。
• 創建視頻摘要：能夠創建視頻的摘要內容。

📦 安裝指南

安裝命令

uv tool install git+https://github.com/sparfenyuk/mcp-youtube

⚠️ 重要提示

如果您已經安裝了該服務器，可以使用 uv tool upgrade --reinstall 命令進行更新。

⚠️ 重要提示

如果您想刪除該服務器，請使用 uv tool uninstall mcp-youtube 命令。

📚 詳細文檔

什麼是MCP？

模型上下文協議 (MCP) 是一個系統，允許 AI 應用（如 Claude Desktop）連接到外部工具和數據源。它為 AI 助手與本地服務和 API 交互提供清晰且安全的方式，同時讓用戶保持控制。

這個服務器的作用是什麼？

該服務器主要具備下載給定視頻的閉合字幕的功能。

實際用例

可以利用該服務器創建視頻摘要。

先決條件

需要安裝uv 工具。

配置

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 檢查器是一個用於使用精美 UI 調試服務器的工具。要運行它，請使用以下命令：

npx @modelcontextprotocol/inspector uv run mcp-youtube

故障排除

消息“無法連接到 MCP 服務器 mcp-youtube”

在配置文件中將 mcp-youtube 可執行文件的完整路徑添加到命令行參數中。