MimikaStudio MCP
Локальный MCP-сервер озвучки для macOS: клонирование голоса, синтез речи и аудиокниги из PDF по команде агента
- 751 ★ репозитория
- Последний коммит
- GPL-3.0
Широкий доступ
Почему такой уровень
- Клонирование голоса по образцу в три секунды позволяет подделать речь живого человека. Без его согласия это нарушает закон и вредит ему напрямую: такими записями обманывают родственников и коллег, подтверждают платежи и сделки от чужого имени
- Инструмент `audiobook_generate_from_file` принимает абсолютный путь, поэтому агент получает доступ к любым документам, которые читает ваш пользователь
- Установочный скрипт ставит пакеты Homebrew, создает окружение Python и скачивает большие модели с внешних источников
Установка
- Работает в
Ручная установка
git clone https://github.com/BoltzmannEntropy/MimikaStudio.git && cd MimikaStudio && ./install.shСтавит Homebrew-пакеты, окружение Python, зависимости и базу. Первая установка занимает несколько минут.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Клонирование голоса по образцу в три секунды позволяет подделать речь живого человека. Без его согласия это нарушает закон и вредит ему напрямую: такими записями обманывают родственников и коллег, подтверждают платежи и сделки от чужого имени
- Инструмент `audiobook_generate_from_file` принимает абсолютный путь, поэтому агент получает доступ к любым документам, которые читает ваш пользователь
- Установочный скрипт ставит пакеты Homebrew, создает окружение Python и скачивает большие модели с внешних источников
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
MimikaStudio запускает на вашем Mac бэкенд озвучки и MCP-сервер к нему. Сервер работает на порту 8010, принимает вызовы JSON-RPC по HTTP и отдает агенту больше 50 инструментов: синтез речи на движках Kokoro, Qwen3-TTS и Chatterbox, управление голосами (список, загрузка, удаление, прослушивание), генерация аудиокниг, сведения о системе, настройки языковой модели и библиотека аудио. Клонировать голос можно по образцу от трех секунд. Аудиокнига собирается из PDF, DOCX, EPUB, Markdown или TXT с очередью глав и готовыми пресетами голосов. Тяжелые задачи идут через очередь заданий, поэтому агент запускает работу, а затем опрашивает ее состояние. Например, инструмент `audiobook_generate_from_file` принимает путь к документу, голос, скорость и формат вывода, а `audiobook_status` показывает ход выполнения. Все вычисления идут на устройстве через MLX на Apple Silicon, аудио никуда не загружается. К MCP и REST-эндпоинтам добавлено окно на Flutter: в разделе настроек видны все инструменты с параметрами и состояние служб. Запуск делает `./bin/mimikactl up`, а режим без окна включается флагом `--no-flutter`.
Для кого. Для владельцев Mac с чипом Apple Silicon, которые хотят озвучивать тексты и документы локальными моделями и управлять этим из Claude Code или Codex.
Подходит, если
- Нужно превратить PDF с конспектом или статьей в аудиокнигу в формате MP3, не отправляя файл в облако
- Агент должен озвучить длинный текст голосом Kokoro с британским произношением и следить за заданием до конца
- Требуется клонировать собственный голос по короткому образцу для озвучки роликов или заметок
- В скрипте надо вызвать синтез речи по HTTP на локальном порту 8010 без графического окна
- Нужно сравнить, как один и тот же текст звучит в Kokoro, Qwen3-TTS и Chatterbox
Не подходит, если
- У вас Windows или Linux: готовые сборки есть только для macOS, на других системах код придется запускать самостоятельно
- Нужен голос другого человека, который не давал на это согласия: клонирование без согласия вредит владельцу голоса и нарушает закон
- Озвучка нужна прямо во время разговора или трансляции: задания идут через очередь, а готовый файл появляется в `backend/outputs/` после завершения
- Нужен облачный сервис с готовой оплатой и поддержкой: MimikaStudio — локальное приложение под лицензией BSL
Пример запроса к агенту
Вызови Mimika MCP audiobook_generate_from_file для /Users/me/notes.pdf, голос bf_emma, формат mp3, и сообщи адрес готового файла.MCP
- Транспорт
- http
- Авторизация
- не нужна
Переменные окружения
SKIP_DICTA- Значение 1 пропускает скачивание модели диакритизации Dicta для иврита (около 1,1 ГБ) при установке.
Ограничения
Установка `./install.sh` ставит Homebrew-пакеты, создает виртуальное окружение Python, тянет тяжелые зависимости и скачивает диакритизатор Dicta ONNX около 1,1 ГБ для иврита. Пропустить эту загрузку можно переменной `SKIP_DICTA=1`. Модели озвучки скачиваются при первом запуске.
Кроме MCP-сервера на порту 8010 приложение поднимает бэкенд API на порту 7693. Ключа или входа MCP-сервер не требует, так что его инструменты может вызвать любой процесс на вашем Mac. Исходный код распространяется по Business Source License 1.1, бинарники — по отдельной лицензии, и свободной лицензией проект не назовешь. Последний выпуск называется v2026.04.1, репозиторий обновлялся 27 октября 2026 года.
Как отключить. Остановите службы командой `./bin/mimikactl mcp stop`, а все сразу командой `./bin/mimikactl down`. Из конфигурации агента уберите запись об адресе `http://127.0.0.1:8010`.
Частые вопросы
Как запустить MCP-сервер MimikaStudio?
Выполните `./install.sh`, активируйте окружение командой `source venv/bin/activate` и запустите `./bin/mimikactl up --no-flutter`. Сервер откроется на порту 8010, состояние покажет `./bin/mimikactl mcp status`.
Как подключить MimikaStudio к Claude Code или Codex?
Подключите локальный HTTP MCP-сервер по адресу `http://127.0.0.1:8010` в настройках клиента. Затем просите агента вызвать нужный инструмент, например `audiobook_generate_from_file`, и следить за заданием через `audiobook_status`.
Работает ли MimikaStudio без интернета?
После скачивания моделей да: вычисления идут на вашем Mac через MLX, аудио не уходит на сторонние серверы. Модели загружаются при первом запуске.
Какие движки озвучки есть в MimikaStudio?
Kokoro-82M для быстрого английского синтеза, Qwen3-TTS в нескольких размерах для клонирования и готовых голосов, Chatterbox Multilingual на 23 языка для клонирования и Supertonic-2 на ONNX.
Работает ли MimikaStudio на Windows?
Готовых сборок для Windows нет: бинарники выходят только для macOS на Apple Silicon. Код кроссплатформенный, но на других системах его придется запускать самостоятельно, а версию для Windows автор обещает позже.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыЛокальный синтез речи для агентов: команда и скилл озвучивают текст, клонируют голос по записи и собирают музыку из партитуры без облака и платы за символы
MCP-сервер озвучки: превращает текст и сценарии с несколькими голосами в аудио через ElevenLabs и хранит историю заданий.
Локальная студия звука с MCP-сервером: агент создает эффекты, музыку, песни и озвучку на моделях с открытыми весами
Локальный MCP-сервер создает музыку и звуковые эффекты, собирает петли, выравнивает громкость и сохраняет звук для игры или видео.
Официальный MCP-сервер MiniMax: синтез речи, клонирование и дизайн голоса, генерация изображений и видео
Агент говорит вслух через колонки, слушает микрофон, переводит на 15 языков и читает PDF с тайским текстом через Paxa Labs
Коротко о README
Автор описывает MimikaStudio как локальное приложение с четырьмя возможностями: клонирование голоса, синтез речи, чтение документов вслух и создание аудиокниг. Описание дополняют примеры озвучки каждого движка, таблица моделей, команды `mimikactl` и пошаговый сценарий превращения PDF в аудиокнигу через MCP.