gradio-transcript-mcp: A Gradio MCP Server for Audio/Video Transcription from URLs

---

title: gradio-transcript-mcp - 文字起こし用 Gradio MCP サーバー emoji: 💬 colorFrom: green colorTo: green sdk: gradio sdk_version: 5.29.0 app_file: app.py pinned: false license: apache-2.0 short_description: URL から音声・動画を文字起こしする Gradio MCP サーバー

gradio-transcript-mcp：URL から音声・動画を文字起こしする Gradio MCP サーバー

概要

gradio-transcript-mcp は、MCP（Model Control Protocol）サーバーとして機能するように設定された Gradio アプリケーションです。URL から音声や動画をテキストに文字起こしするように設計されています。OpenAI の Whisper と ffmpeg（yt-dlp 経由）を実装しており、指定された URL からコンテンツをダウンロードして変換することで、MCP クライアント（Cline など）がマルチメディア入力を効率的に処理できるようにします。WAV 形式への変換や、CPU または GPU の動的な選択など、堅牢な処理に対応しています。

リポジトリには、次の主要コンポーネントが含まれています。

• app.py：MCP サーバーを実行する Gradio アプリケーションのメインファイルです。
• transcription_tool.py：ファイル変換を処理し、文字起こし関数を呼び出すための中核ロジックです。
• transcription.py：transformers ライブラリを使用した Whisper の文字起こし処理を実装しています。
• requirements.txt：必要な Python 依存関係を記載しています。
• ffmpeg_setup.py：ffmpeg が使用可能であることを確認するスクリプトです。
• logging_config.py：ロギングの設定です。

---

インストール

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

   git clone https://huggingface.co/spaces/bismay/gradio-transcript-mcp
   cd gradio-transcript-mcp
   

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

   pip install -r requirements.txt
   

   これにより、gradio[mcp]、yt-dlp、transformers、torch など、必要なライブラリがインストールされます。

---

使用方法

Gradio アプリ／MCP サーバーの実行

MCP サーバーも起動する Gradio アプリケーションを実行するには、次のコマンドを実行します。

python app.py

これにより、ローカルの Gradio ウェブインターフェースが起動し、MCP サーバーが開始されます。サーバーは transcribe_url 関数を MCP ツールとして公開します。

MCP サーバーとしての使用

python app.py を実行すると、MCP クライアントからアクセスできる MCP サーバーがアプリケーションによって起動されます。

公開されるツール：

サーバーは、1 つのツール transcribe_url を公開します。

• 説明： 指定された URL の音声または動画を文字起こしします。URL からメディアをダウンロードして WAV 形式に変換し、TranscriptTool を使用して英語で文字起こしします。
• 入力：
  • url（文字列）：音声または動画ファイルの URL です。
• 出力：（文字列）：音声／動画の英語の文字起こし、またはダウンロードや文字起こしに失敗した場合のエラーメッセージです。

MCP クライアントの接続：

MCP サーバーは通常、ローカルで実行した場合、http://127.0.0.1:7860/gradio_api/mcp/sse でアクセスできます。正確な URL は、Gradio アプリの起動時にコンソールに表示されます。

MCP クライアント（Cline など）をこのサーバーに接続するには、クライアントの設定に構成エントリを追加する必要があります。正確な形式はクライアントによって異なりますが、通常はサーバー名と URL を指定します。

SSE に対応しているクライアント（Cline など）の構成例：

{
  "mcpServers": {
    "gradio-transcript": {
      "url": "http://127.0.0.1:7860/gradio_api/mcp/sse"
    }
  }
}

注：MCP クライアントが SSE ベースのサーバー（Claude Desktop など）に直接対応していない場合は、中継として mcp-remote などのツールを使用する必要があります。

その場合は、mcp-remote などのツールを使用できます。まず Node.js をインストールします。次に、以下を独自の MCP クライアント設定に追加します。

{
  "mcpServers": {
    "gradio": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://127.0.0.1:7860/gradio_api/mcp/sse"
      ]
    }
  }
}

Hugging Face Spaces でホストされているサーバーへの接続

このアプリケーションは Hugging Face Spaces でもホストされており、一般公開されている MCP サーバーを提供しています。次の URL を使用して、このホスト済みサーバーに接続できます。

https://bismay-gradio-transcript-mcp.hf.space/gradio_api/mcp/sse

MCP クライアント（Cline など）をこのホスト済みサーバーに接続するには、次のような構成エントリを追加します。

{
  "mcpServers": {
    "gradio-transcript": {
      "url": "https://bismay-gradio-transcript-mcp.hf.space/gradio_api/mcp/sse"
    }
  }
}

---

ライセンス

このプロジェクトは Apache-2.0 ライセンスの下でライセンスされています。詳細については、LICENSE ファイルを参照してください。

---

貢献

貢献を歓迎します。改善案やバグ修正があれば、イシューを作成するか、プルリクエストを送信してください。