AiNiee-Next MCP

MCP-сервер и CLI для пакетного перевода книг, субтитров и документов: агент ставит задачи в очередь и следит за ходом перевода

  • 245 ★ репозитория
  • Последний коммит
  • AGPL-3.0
MCP-сервер

Расширенный доступ

Почему такой уровень

  • Тратит токены платных моделей по вашим ключам API и держит локальный веб-сервер, доступный по LAN
  • Через MCP агент меняет конфигурацию, очередь и плагины и запускает задачи перевода
Все причины и проверки

shadowloveelysia/ainiee-next

Установка

Работает в

Ручная установка

codex mcp add ainiee-cli -- /path/to/AiNiee-CLI/Tools/MCPServer/codex_stdio_launcher.sh

Нужен клон проекта и зависимости MCP: `uv --directory . add mcp fastapi "uvicorn[standard]" requests`. Для первого запуска задайте `startup_timeout_sec` около 90 в ~/.codex/config.toml.

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • Тратит токены платных моделей по вашим ключам API и держит локальный веб-сервер, доступный по LAN
  • Через MCP агент меняет конфигурацию, очередь и плагины и запускает задачи перевода

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

AiNiee-Next — командная версия переводчика AiNiee на базе `uv` для долгих и пакетных задач. Основной интерфейс CLI и TUI, рядом работают веб-панель, очередь задач, плагины и необязательный MCP-сервер в `Tools/MCPServer`. Он поддерживает более 20 форматов (Epub, Docx, Txt, Srt, Ass, Vtt, Lrc, Json, Po и другие), асинхронные запросы со 100 и более параллельными потоками, возобновление после сбоя, переключение между несколькими API при ошибках и кэш контекста для Anthropic, Google и Amazon Bedrock. MCP-сервер не дублирует бизнес-логику: он запускает встроенный WebServer и отдает его маршруты внешнему агенту. Подключиться можно по stdio (для Codex есть launcher `codex_stdio_launcher.sh`) или по `streamable-http` на `http://127.0.0.1:8765/mcp`. Через MCP агент читает и сохраняет конфигурацию, управляет профилями, плагинами, глоссарием и очередью, запускает и останавливает задачи и читает их состояние. Первым делом агенту советуют вызвать `get_mcp_usage_manual`, `get_mcp_security_policy` и `get_mcp_tool_categories`, а не угадывать параметры. В корне лежит `SKILL.md` с правилами для внешних агентов: приоритет входных файлов пользователя, вопрос перед запуском AiNiee для TXT длиннее 500 строк и границы между MCP и запасным REST-сервисом в `Tools/Skills/`. Ключи API в ответах MCP скрываются.

Для кого. Переводчикам книг, субтитров и игровых текстов, которые гоняют большие файлы через API моделей, и тем, кто хочет поручить запуск и контроль перевода агенту.

Подходит, если

  • Книга в Epub или большая рассылка субтитров переводится пакетом, и ход перевода должен вести агент
  • Файл на 20 тысяч строк нужно перевести параллельно, с возобновлением после обрыва связи
  • Нужен глоссарий и RAG по прошлым переводам для единства терминов в длинном тексте
  • Агент на Codex или другом MCP-клиенте должен поставить задачу в очередь и забрать результат
  • Запуск идет на сервере без экрана: для этого есть режим без интерфейса и веб-панель

Не подходит, если

  • Текст короткий: разовый перевод проще сделать самим агентом, и SKILL.md сам разрешает это для TXT до 500 строк
  • Нет доступа к API моделей и нет локальной модели: переводом занимается внешняя модель
  • Нужен английский интерфейс и документация: основной README на китайском, есть переводы

Пример запроса к агенту

Через AiNiee MCP переведи книгу book.epub с японского на русский, поставь задачу в очередь и покажи статус, когда пойдет перевод

MCP

Транспорт
stdio, http
Авторизация
не нужна

Переменные окружения

AINIEE_MCP_DISABLE_RUNNING_REUSE
Значение `1` отключает повторное использование уже запущенного MCP-сервиса stdio-процессом.
AINIEE_MCP_REGISTER_ROUTE_TOOLS
Значение `1` регистрирует каждый маршрут веб-API отдельным инструментом, как в старых версиях.

Ограничения

  • Нужны Python 3.12 и `uv`, версии 3.11 и ниже не подходят. Установка идет скриптами `prepare.bat` или `prepare.sh` либо через `uv run ainiee_cli.py`.
  • Перевод выполняют внешние модели по ключу API (в README часто упоминается DeepSeek), расходуются токены и деньги.
  • Адрес `streamable-http` доступен и по локальной сети. Чувствительные маршруты требуют куки веб-панели или токен моста, поэтому агенту нельзя ходить в них прямым HTTP.
  • Лицензия AGPL-3.0, основной README на китайском языке.

Как отключить. Уберите MCP-сервер из настроек клиента (для Codex `codex mcp remove ainiee-cli`) и остановите процесс AiNiee. Папку проекта вместе с `.venv`, профилями и очередью можно удалить.

Частые вопросы

Как подключить AiNiee-Next к Codex?

Выполните `codex mcp add ainiee-cli -- /path/to/AiNiee-CLI/Tools/MCPServer/codex_stdio_launcher.sh`. Если зависимости еще не кэшированы, увеличьте `startup_timeout_sec` в `~/.codex/config.toml`, например до 90.

Какой адрес у MCP по HTTP?

`http://127.0.0.1:8765/mcp` на этой машине и `http://<ваш IP>:8765/mcp` в локальной сети. При смене `mcp_server_port` нужно изменить адрес и в клиенте.

Видит ли агент мои ключи API?

Нет. MCP скрывает `api_key`, `access_key` и `secret_key` в ответах, а маскированное значение сервер отказывается принять обратно как новый ключ.

Какие форматы файлов переводятся?

Более 20 форматов: Epub, Docx, Txt, Srt, Ass, Vtt, Lrc, Json, Po, Paratranz и другие. Через Calibre обрабатываются также `.mobi`, `.azw3`, `.kepub` и `.fb2`.

Что такое SKILL.md в корне репозитория?

Это правила для внешних агентов: как брать входные файлы пользователя, когда спрашивать о запуске и как не смешивать MCP с запасным REST-сервисом. Инструментом перевода он не служит.

Обсуждение

Вопросов и отзывов пока нет.

MCP-серверы
Официальный

MCP перевод от команды LibreTranslate: агент определяет язык текста, переводит его и получает список поддерживаемых языков через три инструмента

MCP-серверРасширенный доступ7Звезды репозитория

Плагин AiToEarn подключает к Claude Code и Codex публикацию в 14 соцсетях, создание видео и картинок и работу с комментариями.

ПлагинШирокий доступ27,6 тыс.Звезды репозитория

MCP-сервер и CLI для YouTube: серверный пересказ субтитров, отчеты по видео, мониторинг каналов и анализ комментариев.

MCP-серверРасширенный доступ53Звезды репозитория
Официальный

MCP-сервер планировщика соцсетей OpenPost: агент смотрит календарь и аккаунты, готовит черновики, планирует и публикует посты, разбирает комментарии

MCP-серверШирокий доступ906Звезды репозитория
Официальный

Официальный сервер Umbraco выдает агенту Management API: документы, медиа, типы документов и данных, права по пользователю API

MCP-серверШирокий доступ39Звезды репозитория

MCP-сервер для Meta Marketing API v26: 134 инструмента для рекламных кампаний Facebook и Instagram, аудиторий, креативов и отчетов

MCP-серверШирокий доступ94Звезды репозитория

Сравнение с похожими

Карточки с тем же главным запросом: чем они отличаются.

ИнструментОфициальныйАвторизацияЗвезды репозиторияГлавное отличие
AiNiee-Next (эта карточка)нетне нужна245
ChatGPT Subtitle Translatorнет391CLI для длинных SRT с учетом предыдущего перевода
translate-bookнет2 402скилл для перевода целых книг в PDF, DOCX и EPUB через параллельных субагентов

Коротко о README

README открывается описанием CLI-версии AiNiee и рекомендацией новичкам работать через внешнего агента, подключенного по MCP. Дальше идут диагностика проблем, замер производительности (20 тысяч строк за четыре минуты на 50 потоках), список особенностей и быстрый старт скриптами или вручную через uv. Заканчивается страница аргументами командной строки для скриптов.

Бейдж для README

Сообщить о проблеме