MCP Audio Transcriber

MCP オーディオトランスクリプター

AssemblyAIのAPIを介してモデルコンテキストプロトコル（MCP）を実装する、Docker化されたPythonツールです。音声ファイルをアップロードまたは指定すると、構造化されたJSON形式の文字起こしが提供されます。

特徴

• AssemblyMCP : AssemblyAIのREST APIを使用する具体的なMCP実装
• コマンドラインインターフェース( app.py ):
  python app.py <input_audio> <output_json>
• Streamlit ウェブ UI ( streamlit_app.py ):
  • ローカルファイルをアップロードするか、URLを貼り付けます
  • 「文字起こし」をクリック
  • トランスクリプトをプレビューし、JSON をダウンロードする
• 環境の一貫性と移植性のためのDocker サポート

前提条件

• Python 3.10以上
• AssemblyAI APIキー
• ffmpeg (ローカルファイルを使用する場合のローカルデコード用)
• （オプション）Dockerデスクトップ/エンジン
• （オプション）Streamlit（ pip install streamlit ）

🔧 インストール

1. リポジトリをクローンする
   git clone https://github.com/ShreyasTembhare/MCP---Audio-Transcriber.git cd MCP---Audio-Transcriber
2. .envを作成する
   ASSEMBLYAI_API_KEY=your_assemblyai_api_key_here
3. .gitignoreに以下が含まれていることを確認します。
   .env
4. Pythonの依存関係をインストールする
   pip install --upgrade pip pip install -r requirements.txt
5. ffmpegをインストールする
   • Ubuntu/Debian: sudo apt update && sudo apt install ffmpeg -y
   • Windows: https://ffmpeg.orgからダウンロードし、 bin/ PATH に追加します。

使用法

1. CLIトランスクリプション

• <input_audio> : AssemblyAI でサポートされている任意のファイルまたは URL
• <output_json> : 生成されたJSONのパス

例：

2. Streamlit Web UI

• http://localhost:8501を開きます。
• オーディオURLをアップロードまたは入力してください
• 「文字起こし」をクリック
• JSON結果をダウンロードする

3. ドッカー

イメージをビルドします。

実行します（data/ フォルダをマウントします）。

次に検査します:

Windows PowerShell:

プロジェクト構造