Yt Description MCP

🚀 YouTube 转录提取器 MCP 🎥

このツールは、モデルコンテキストプロトコル（MCP）に基づいて構築されたサーバーで、AIアシスタントがYouTube動画から直接字幕を抽出できるようにします。CursorおよびClaude Desktopとの統合を目的として設計されており、AIがYouTube動画の内容を直接分析および処理できるようになります。

🚀 クイックスタート

YouTube 转录提取器 MCPは、AIアシスタントがYouTube動画から字幕を抽出するためのサーバーです。CursorやClaude Desktopと統合することで、AIが動画内容を直接分析できます。

✨ 主な機能

• 🎯 公開されている任意のYouTube動画から字幕を抽出できます。
• 🔌 CursorおよびClaude Desktopと簡単に統合できます。
• 🚀 TypeScriptを使用しているため、型安全が保証されます。
• 📦 インストールとデプロイの手順が簡単です。
• 🛠️ モデルコンテキストプロトコルに基づいて構築されています。

📦 インストール

前提条件

• Node.js（v16以上）
• pnpm（推奨）またはnpm
• 字幕を抽出するYouTube動画のリンク

インストール手順

1. リポジトリをクローンします。

git clone https://github.com/yourusername/yt-mcp.git
cd yt-mcp

2. 依存関係をインストールします。

pnpm install

3. プロジェクトをビルドします。

pnpm run build

📚 ドキュメント

設定

Cursorの場合

1. Cursorの設定を開きます。
2. MCPに移動し、新しいMCPサーバーを追加します。
3. 以下の設定を使用します。
   • 名前：youtube-transcript
   • タイプ：コマンド
   • コマンド：node /絶対パス/to/yt-mcp/build/index.js

Claude Desktopの場合

Claude Desktopの設定ファイルに以下の設定を追加します。

{
  "mcpServers": {
    "youtube-transcript": {
      "command": "node",
      "args": ["/絶対パス/to/yt-mcp/build/index.js"]
    }
  }
}

使用方法

設定が完了したら、AIは動画リンクを渡すことで字幕を抽出できます。例：

// AIはこの形式を内部で使用して呼び出します。
const transcript = await extractTranscript({
  input: "https://www.youtube.com/watch?v=VIDEO_ID"
});

🔧 技術詳細

サーバーは以下の技術を使用して構築されています。

• @modelcontextprotocol/sdk - MCPの実装に使用
• youtube-transcript - 字幕抽出に使用
• TypeScript - 型安全と良好な開発体験を提供

📄 ライセンス

MIT

⚠️ 重要提示

• このツールは公開されているYouTube動画のみを処理できます。
• 動画に字幕機能が有効になっている必要があります。
• 一部の動画は自動生成された字幕を使用している場合があり、精度が低下する可能性があります。

💡 使用建议

一般的な問題の解決

1. 「動画IDが見つかりません」エラー
   • YouTubeリンクが完全かつ正しいことを確認してください。
   • 動画が公開されていることを確認してください。
2. 「字幕が利用できません」エラー
   • 動画に字幕機能が有効になっていることを確認してください。
   • ツールが正常に動作することを確認するために、他の動画を試してみてください。
3. ビルドエラー
   • すべての依存関係がインストールされていることを確認してください。
   • Node.jsのバージョンがv16以上であることを確認してください。