MCP-сервер CLOVA Speech Lecture

MCP-сервер для STT (преобразования речи в текст) и суммаризации записей лекций.
Вызывает API Naver CLOVA Speech / CLOVA Studio из агента Google ADK.

Предоставляемые инструменты

Начало работы

1. Получение API-ключей

CLOVA Speech (STT)

1. Войдите в Naver Cloud Platform

2. AI Services → CLOVA Speech → Заявка на использование

3. После создания сервиса скопируйте Secret Key

CLOVA Studio (Суммаризация)

1. AI Services → CLOVA Studio → Заявка на использование

2. Создайте приложение в Playground

3. Скопируйте API-ключ и ID приложения

2. Настройка .env

cp .env .env.local   # 실제 값으로 수정

CLOVA_SPEECH_API_KEY=실제_키_입력
CLOVA_STUDIO_CLIENT_ID=실제_Client_ID
CLOVA_STUDIO_CLIENT_SECRET=실제_Client_Secret
CLOVA_STUDIO_APP_ID=실제_앱_ID

3. Запуск

# Docker
docker-compose up -d

# 로컬 실행
pip install -r requirements.txt
python app/main.py

4. Подключение агента ADK

# agent.py 예시
tools = [
    MCPToolset(
        connection_params=SseServerParams(url="http://localhost:8002/sse")
    )
]

Процесс обработки лекций

[강의 오디오 파일]
       ↓
transcribe_lecture_submit(file_path, enable_diarization=True)
       ↓ (task_id 반환)
get_transcription_result(task_id)   ← 완료까지 자동 폴링
       ↓ (full_text 반환)
summarize_lecture(text)
       ↓
[요약문 + 키워드]

Поддерживаемые форматы аудио

.wav .mp3 .flac .m4a .aac .ogg

Поддерживаемые языки