JuhongPark/mcp-server-pronunciation

Assess a recorded pronunciation attempt

Оценивает последнюю запись (или конкретный аудиофайл) без перезаписи. Когда передан `reference_text`, ассессор: - Выравнивает речь пользователя по словам относительно эталона (Needleman-Wunsch; одиночные удаления/вставки больше не каскадируют в фантомные замены). - Запускает принудительное выравнивание wav2vec2 CTC, чтобы проверить, какие слова из эталона пользователь действительно произнёс — уменьшает количество ошибочных транскрипций из-за смещения Whisper на редких именах собственных и доменных терминах, напрямую сверяя акустические свидетельства с эталоном. - Предоставляет пословную обратную связь на уровне фонем (ожидаемая и произнесённая IPA, слабые фонемы) из CMUdict. - Предоставляет опциональные подсказки и упражнения по произношению для профиля учащегося, если совпадает набор правил. В комплект входит профиль для корейского L1, включающий такие паттерны, как r/l, th→s, удаление конечных кластеров и вставка гласного в начале слога. - Добавляет заметки по просодии: расстановка ударений в словах, вопросительная интонация в конце повествовательных предложений, паузы хезитации внутри клаузы. Без эталона выполняются только транскрипция и просодия. Аргументы: reference_text: Ожидаемый текст, который пользователь пытался произнести (опционально). audio_path: Путь к WAV-файлу. Если не указан, используется последняя запись. Возвращает: Подробный отчёт об оценке произношения (markdown).

Check microphone devices

Списывает доступные устройства ввода аудио и проверяет доступ к микрофону. Используйте, если пользователь жалуется на проблемы с записью — показывает, какие устройства доступны и какое из них установлено по умолчанию. Возвращает: Список доступных микрофонов.

Voice conversation with English feedback

Записывает речь пользователя, расшифровывает её и возвращает расшифровку и краткий отзыв по английскому. Это основной инструмент для голосовых разговоров: вызовите его, прочитайте расшифровку + отзыв, затем ответьте своими словами в разговорном ключе — вплетая отзыв естественно или упоминая его, только если это важно. Запись автоматически останавливается, когда пользователь заканчивает говорить (определение тишины). Используйте этот инструмент, когда: - Пользователь хочет пообщаться с вами голосом, а не текстом. - Пользователь хочет получать повседневный отзыв по английскому во время разговора. - Вы хотите услышать, что сказал пользователь, а не читать набранное сообщение. Для целенаправленного упражнения, где пользователь читает конкретное предложение, используйте `practice`. Args: target_hint: Опционально. Устанавливайте только если пользователь явно пытается произнести конкретную фразу (например, он спросил «как сказать X?» и вы сказали ему X). Оставьте пустым для свободной беседы. duration: Максимальная длительность записи в секундах (по умолчанию 30, макс. 120). Автоматически останавливается раньше при тишине. Возвращает: Markdown-отчёт, содержащий расшифровку речи пользователя, краткий отзыв по английскому (произношение + грамматика + беглость) и раздел 'For Claude' с рекомендациями по ответу.

Focused pronunciation drill

Drill mode: пользователь читает вслух конкретное предложение и получает подробную оценку произношения. Используйте этот режим, когда пользователь явно хочет практиковать чтение определённого предложения, а не для свободного общения. Для голосового разговора с неформальной обратной связью используйте `converse`. Запись автоматически останавливается, когда пользователь заканчивает говорить. Аргументы: reference_text: предложение, которое пользователь будет читать вслух. duration: максимальная длительность записи в секундах (по умолчанию 15, максимум 120). Возвращает: Подробный отчёт об оценке произношения.

Random pronunciation drill

Выбирает случайное предложение для отработки и сразу запускает тренировку. Объединяет `suggest_sentence` и `practice` в один шаг: выбирает предложение по заданным критериям, затем записывает и оценивает. Аргументы: focus: Область фонем. Варианты: "th", "f_v", "r_l", "vowels", "general". Если не указан, выбирается случайно. difficulty: Уровень сложности. Варианты: "beginner", "intermediate", "advanced". Если не указан, выбирается случайно. duration: Максимальная длительность записи в секундах (по умолчанию 15, максимум 120). Возвращает: Предложение для чтения, за которым следует оценка произношения.

Record microphone audio

Записывает аудио с микрофона без анализа. Запись автоматически останавливается, когда пользователь заканчивает говорить (детекция тишины). Длительность — это максимальное время — можно не ждать полной длительности. В большинстве случаев пользуйтесь `converse` или `practice` — они записывают И анализируют за один шаг. Используйте `record` отдельно только если нужен сырой WAV-файл. Аргументы: duration: Максимальная длительность записи в секундах (по умолчанию 10, максимум 120). Возвращает: Путь к записанному WAV-файлу.

Retry the last pronunciation drill

Повторить последнее предложение, которое тренировал пользователь. Перезаписывает и переоценивает, используя тот же эталонный текст из предыдущего вызова `practice` или `converse`. Используйте это, чтобы дать пользователю попробовать снова после получения обратной связи. Аргументы: duration: Максимальная длительность записи в секундах (по умолчанию 15, максимум 120). Возвращает: Отчет об оценке произношения для новой попытки.

Suggest a practice sentence

Предложите пользователю предложение для практики, которое он сможет прочитать вслух. Аргументы: focus: Область фонетического акцента. Варианты: "th", "f_v", "r_l", "vowels", "general". Если не указано, выбирается случайно. difficulty: Уровень сложности. Варианты: "beginner", "intermediate", "advanced". Если не указано, выбирается случайно. Возвращает: Предложение для практики с указанием его фокуса и сложности.