AiNiee-Next MCP
An MCP server and CLI for batch translation of books, subtitles and documents: an agent queues jobs and tracks progress
- 245 ★ on the repository
- Last commit
- AGPL-3.0
Extended access
Why this level
- Spends paid-model tokens on your API keys and runs a local web server reachable over the LAN
- Through MCP the agent edits configuration, the queue and plugins and starts translation jobs
Install
- Works in
Manual install
codex mcp add ainiee-cli -- /path/to/AiNiee-CLI/Tools/MCPServer/codex_stdio_launcher.shNeeds a clone of the project and the MCP dependencies: `uv --directory . add mcp fastapi "uvicorn[standard]" requests`. For the first start set `startup_timeout_sec` to about 90 in ~/.codex/config.toml.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Spends paid-model tokens on your API keys and runs a local web server reachable over the LAN
- Through MCP the agent edits configuration, the queue and plugins and starts translation jobs
This is third-party code. Review the repository files before installing.
What it does
AiNiee-Next is the command-line edition of the AiNiee translator, built on `uv` for long and batch jobs. The main interface is CLI and TUI, alongside a web panel, a task queue, plugins and an optional MCP server in `Tools/MCPServer`. It supports more than 20 formats (Epub, Docx, Txt, Srt, Ass, Vtt, Lrc, Json, Po and others), async requests with 100 or more parallel threads, resume after failure, failover between several APIs and context caching for Anthropic, Google and Amazon Bedrock. The MCP server does not duplicate business logic: it starts an embedded WebServer and exposes its routes to an external agent. You can connect over stdio (Codex has a `codex_stdio_launcher.sh` launcher) or over `streamable-http` at `http://127.0.0.1:8765/mcp`. Through MCP the agent reads and saves configuration, manages profiles, plugins, glossaries and the queue, starts and stops jobs and reads their status. The agent is advised to call `get_mcp_usage_manual`, `get_mcp_security_policy` and `get_mcp_tool_categories` first instead of guessing parameters. The root holds a `SKILL.md` with rules for external agents: user-supplied input files come first, a question before launching AiNiee for a TXT over 500 lines, and the boundaries between MCP and the fallback REST service in `Tools/Skills/`. API keys are masked in MCP responses.
Who it is for. Translators of books, subtitles and game text who run large files through model APIs, and anyone who wants an agent to start and supervise the translation.
Good fit when
- A book in Epub or a large set of subtitles is translated as a batch and an agent should run the job
- A 20,000-line file has to be translated in parallel with resume after a connection drop
- You need a glossary and RAG over earlier translations for consistent terms in a long text
- An agent on Codex or another MCP client should queue a job and collect the result
- It runs on a headless server: headless mode and the web panel exist for that
Not a fit when
- The text is short: a one-off translation is simpler for the agent itself, and SKILL.md allows that for a TXT up to 500 lines
- You have no model API access and no local model: translation is done by an external model
- You need an English interface and docs: the main README is Chinese, with translated versions
Example request
Through the AiNiee MCP translate book.epub from Japanese to Russian, queue the job and show the status once translation startsMCP
- Transport
- stdio, http
- Authentication
- not required
Environment variables
AINIEE_MCP_DISABLE_RUNNING_REUSE- The value `1` stops a stdio process from reusing an already running MCP service.
AINIEE_MCP_REGISTER_ROUTE_TOOLS- The value `1` registers every web API route as its own tool, as in older versions.
Limitations
- Python 3.12 and `uv` are required, and 3.11 or lower will not work. Installation uses the `prepare.bat` or `prepare.sh` scripts or `uv run ainiee_cli.py`.
- Translation is done by external models through an API key (DeepSeek is often mentioned in the README), so tokens and money are spent.
- The `streamable-http` address is reachable on the local network too. Sensitive routes need the web panel cookie or a bridge token, so the agent must not reach them with direct HTTP.
- The license is AGPL-3.0 and the main README is in Chinese.
How to disable. Remove the MCP server from the client settings (for Codex `codex mcp remove ainiee-cli`) and stop the AiNiee process. The project folder with `.venv`, profiles and the queue can be deleted.
FAQ
How do I connect AiNiee-Next to Codex?
Run `codex mcp add ainiee-cli -- /path/to/AiNiee-CLI/Tools/MCPServer/codex_stdio_launcher.sh`. If dependencies are not cached yet, raise `startup_timeout_sec` in `~/.codex/config.toml`, for example to 90.
What is the MCP HTTP address?
`http://127.0.0.1:8765/mcp` on this machine and `http://<your IP>:8765/mcp` on the local network. If you change `mcp_server_port`, update the address in the client too.
Does the agent see my API keys?
No. MCP masks `api_key`, `access_key` and `secret_key` in responses, and the server refuses to accept a masked placeholder back as a new key.
Which file formats can be translated?
More than 20 formats: Epub, Docx, Txt, Srt, Ass, Vtt, Lrc, Json, Po, Paratranz and others. Calibre also handles `.mobi`, `.azw3`, `.kepub` and `.fb2`.
What is the SKILL.md in the repository root?
It is a rule set for external agents: how to take the user's input files, when to ask before launching and how not to mix MCP with the fallback REST service. It is not a translation tool.
Discussion
No questions or reviews yet.
Related
MCP serversLibreTranslate MCP: machine translation for agents
LibreTranslate MCP
A translation MCP from the LibreTranslate team: the agent detects a text's language, translates it and lists supported languages with three tools
The AiToEarn plugin connects Claude Code and Codex to publishing on 14 social networks, plus video and image creation.
An MCP server and CLI for YouTube: server side transcript summaries, video reports, channel monitoring and comment analysis.
MCP server of the OpenPost social scheduler: an agent reviews the calendar and accounts, drafts, schedules and publishes posts and triages comments
Umbraco MCP: managing Umbraco CMS through an agent
Umbraco-CMS-MCP-Dev
Official Umbraco server gives the agent the Management API: documents, media, document and data types, with API user rights
Meta Ads MCP: Facebook and Instagram ads
Mikusnuz Meta Ads MCP
An MCP server for the Meta Marketing API v26: 134 tools for Facebook and Instagram ad campaigns, audiences, creatives and reports
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| AiNiee-Next (this card) | no | not required | 245 | |
| ChatGPT Subtitle Translator | no | 391 | a CLI for long SRT files that takes the previous translation into account | |
| translate-book | no | 2,402 | a skill for translating whole books in PDF, DOCX and EPUB through parallel subagents |
README in short
The README opens with a description of the CLI edition of AiNiee and a recommendation for beginners to work through an external agent connected over MCP. It continues with problem diagnostics, a performance measurement (20,000 lines in four minutes at 50 threads), a feature list and a quick start with scripts or manually through uv. The page ends with command-line arguments for scripting.