Video Fetch MCP

🚀 🎬 Video Fetch MCP

MCPプロトコルに基づく多プラットフォームのビデオダウンロードサーバーで、1000以上のビデオプラットフォームをサポートします。

🚀 クイックスタート

MCP プロトコルモード

あなたのMCPクライアントの設定ファイルに以下を追加します：

{
  "mcpServers": {
    "video-fetch": {
      "command": "npx",
      "args": ["@pickstar-2002/video-fetch-mcp@latest"]
    }
  }
}

REST API モード

# REST API サーバーを起動する
npx @pickstar-2002/video-fetch-mcp@latest api

# または、インストール済みのバージョンを使用する
video-fetch-mcp api

✨ 主な機能

• 🎯 多プラットフォーム対応：yt-dlpに基づいて、YouTube、哔哩哔哩、抖音、Twitterなど1000以上のプラットフォームをサポートします。
• 🔄 2種類の動作モード：MCPプロトコルモードとREST APIモードをサポートします。
• 📊 リアルタイムの進捗追跡：ダウンロードの進捗状況、速度、残り時間などのリアルタイム情報を提供します。
• 🎵 複数のフォーマット対応：ビデオのダウンロード、オーディオの抽出、字幕のダウンロードをサポートします。
• 🛡️ 型安全：TypeScriptで開発されており、完全な型定義を提供します。
• 📝 詳細なログ：完全な操作ログの記録とエラー追跡を行います。

📦 インストール

MCPサーバーとして使用する（推奨）

# @latest タグを使用して最新バージョンを取得する（推奨）
npx @pickstar-2002/video-fetch-mcp@latest

グローバルインストール

npm install -g @pickstar-2002/video-fetch-mcp@latest

ローカルインストール

npm install @pickstar-2002/video-fetch-mcp@latest

💻 使用例

基本的な使用法

MCPツール

サーバーは以下のMCPツールを提供します。

get_video_info

ビデオの詳細情報を取得します。

{
  "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
}

download_video

ビデオファイルをダウンロードします。

{
  "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
  "outputPath": "./downloads",
  "quality": "best",
  "extractAudio": false,
  "downloadSubtitles": true
}

get_task_status

ダウンロードタスクの状態を照会します。

{
  "taskId": "uuid-task-id"
}

cancel_task

ダウンロードタスクをキャンセルします。

{
  "taskId": "uuid-task-id"
}

REST API

ビデオ情報の取得

curl -X POST http://localhost:8080/api/v1/video/info \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"}'

ダウンロードの開始

curl -X POST http://localhost:8080/api/v1/video/download \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
    "outputPath": "./downloads",
    "quality": "best"
  }'

タスクの状態を確認する

curl http://localhost:8080/api/v1/task/{taskId}

📚 ドキュメント

サポートされているプラットフォーム

• 🎥 YouTube (youtube.com, youtu.be)
• 📺 哔哩哔哩 (bilibili.com)
• 🎵 抖音 (douyin.com)
• 🐦 Twitter/X (twitter.com, x.com)
• 📷 Instagram (instagram.com)
• 📘 Facebook (facebook.com)
• 🎬 Vimeo (vimeo.com)
• 🎮 Twitch (twitch.tv)
• 📱 TikTok (tiktok.com)
• 🔴 Reddit (reddit.com)
• 📺 Dailymotion (dailymotion.com)
• ...および1000以上の他のプラットフォーム

設定オプション

環境変数

# サービスポート（デフォルト：8080）
PORT=8080

# ログレベル（デフォルト：info）
LOG_LEVEL=info

# yt-dlpのタイムアウト時間（デフォルト：300000ms）
YTDLP_TIMEOUT=300000

ダウンロードオプション

• quality: ビデオの品質 (best, worst, bestvideo, bestaudio)
• outputTemplate: ファイル名のテンプレート (デフォルト: %(title)s.%(ext)s)
• extractAudio: オーディオを抽出するかどうか
• audioFormat: オーディオフォーマット (mp3, aac, wav, flac)
• downloadSubtitles: 字幕をダウンロードするかどうか
• subtitleLangs: 字幕の言語リスト

🔧 技術詳細

IDEの設定

Cursor

.cursor/mcp_config.json に以下を追加します：

{
  "mcpServers": {
    "video-fetch": {
      "command": "npx",
      "args": ["@pickstar-2002/video-fetch-mcp@latest"]
    }
  }
}

WindSurf

.windsurf/mcp_config.json に以下を追加します：

{
  "mcpServers": {
    "video-fetch": {
      "command": "npx",
      "args": ["@pickstar-2002/video-fetch-mcp@latest"]
    }
  }
}

CodeBuddy

.codebuddy/mcp_config.json に以下を追加します：

{
  "mcpServers": {
    "video-fetch": {
      "command": "npx",
      "args": ["@pickstar-2002/video-fetch-mcp@latest"]
    }
  }
}

開発

ローカル開発

# リポジトリをクローンする
git clone https://github.com/pickstar-2002/video-fetch-mcp.git
cd video-fetch-mcp

# 依存関係をインストールする
npm install

# 開発モード
npm run dev

# ビルド
npm run build

# 起動
npm start

プロジェクト構造

video-fetch-mcp/
├── src/
│   ├── services/
│   │   ├── mcp-server-fixed.ts    # MCP サーバーの実装
│   │   ├── rest-api-server.ts     # REST API サーバー
│   │   └── ytdlp-service.ts       # yt-dlp のコアサービス
│   ├── utils/
│   │   └── logger.ts              # ログツール
│   ├── types.ts                   # 型定義
│   ├── config.ts                  # 設定ファイル
│   └── index.ts                   # エントリーファイル
├── dist/                          # コンパイル出力
└── downloads/                     # デフォルトのダウンロードディレクトリ

APIドキュメント

REST APIエンドポイント

MCPツール

🔧 トラブルシューティング

よくある問題

❌ Connection closed エラー

これは通常、npx のキャッシュ問題によって引き起こされます。以下の順序で解決を試みてください。

1. @latest タグを使用することを確認する（推奨ソリューション）

npx @pickstar-2002/video-fetch-mcp@latest

2. 特定のバージョンに固定する（代替ソリューション）

npx @pickstar-2002/video-fetch-mcp@1.0.0

3. npx キャッシュをクリアする（最終手段）

# npx キャッシュをクリアする
npx clear-npx-cache

# または手動でクリアする
rm -rf ~/.npm/_npx
# Windowsユーザーは：rmdir /s %USERPROFILE%\.npm\_npx

# その後、再度実行する
npx @pickstar-2002/video-fetch-mcp@latest

❌ yt-dlp が見つからない

システムにPythonとyt-dlpがインストールされていることを確認してください。

# yt-dlp をインストールする
pip install yt-dlp

# またはcondaを使用する
conda install -c conda-forge yt-dlp

❌ ポートが使用中

ポート設定を変更します。

PORT=8081 npx @pickstar-2002/video-fetch-mcp@latest api

❌ 権限エラー

出力ディレクトリに書き込み権限があることを確認してください。

mkdir -p ./downloads
chmod 755 ./downloads

デバッグモード

詳細なログを有効にします。

LOG_LEVEL=debug npx @pickstar-2002/video-fetch-mcp@latest

🤝 コントリビューション

コードの貢献を歓迎します！以下の手順に従ってください。

1. このリポジトリをForkする
2. 機能ブランチを作成する (git checkout -b feature/amazing-feature)
3. 変更をコミットする (git commit -m 'Add some amazing feature')
4. ブランチにプッシュする (git push origin feature/amazing-feature)
5. Pull Requestを作成する

📝 更新履歴

v1.0.0

• 🎉 初期バージョンのリリース
• ✅ MCPプロトコルとREST APIの2種類のモードをサポート
• ✅ yt-dlpを統合し、1000以上のプラットフォームをサポート
• ✅ リアルタイムの進捗追跡とタスク管理
• ✅ TypeScriptによる型安全

📄 ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。

📞 連絡先

問題や提案がある場合は、以下の方法で連絡してください。 微信: pickstar_loveXX

⭐ このプロジェクトが役に立った場合は、Starをしていただけると幸いです！