# i18n-agent

Переводит текст и файлы с учётом аудитории и региона, сохраняя структуру поддерживаемых форматов. Подключите его, чтобы поручать локализацию ИИ-агенту.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Автор: i18n-agent
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/i18n-agent/mcp-client
- Обновлён: 2026-05-20
- HTML: https://affpapa.org/nevibecode/mcp/i18n-agent

## Что делает

i18n-agent подключает переводческий сервис к Claude Code и другим поддерживаемым IDE через MCP. Сервер переводит отдельный текст и файлы, учитывая заданную аудиторию или регион. В числе форматов — JSON, YAML, CSV, XML, Markdown, PDF и документы Word; для структурированных файлов сохраняются формат и содержимое.

Для работы нужен API-ключ `I18N_AGENT_API_KEY`. В Claude Code сервер можно подключить по HTTP или запустить через `npx` по протоколу stdio. Это важно учесть: вариант stdio также требует задать `MCP_SERVER_URL`, а без API-ключа сервису не передать учётные данные.

Сервер поддерживает 48 языков, включая региональные варианты. Для файлов больше 50 KB предусмотрена асинхронная обработка с отслеживанием статуса; большие задания могут выполняться до 10 минут. Поэтому перевод объёмного файла не обязательно завершится в одном ответе агента.

## Требования
- Нужно: Node.js (команды через npx)
- Удалённый сервер: `https://mcp.i18nagent.ai/mcp`
- Переменные окружения: `I18N_AGENT_API_KEY`, `MCP_SERVER_URL` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

1. **Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http i18n-agent https://mcp.i18nagent.ai/mcp
```

2. **Командой платформы**
```bash
claude mcp add --env I18N_AGENT_API_KEY=<I18N_AGENT_API_KEY> --env MCP_SERVER_URL=<MCP_SERVER_URL> --transport stdio i18n-agent -- npx -y @i18n-agent/mcp-client
```
Вместо <…> подставьте свои значения

### Codex

1. **Командой платформы: удалённый сервер**
```bash
codex mcp add i18n-agent --url https://mcp.i18nagent.ai/mcp
```

2. **Командой платформы**
```bash
codex mcp add i18n-agent --env I18N_AGENT_API_KEY=<I18N_AGENT_API_KEY> --env MCP_SERVER_URL=<MCP_SERVER_URL> -- npx -y @i18n-agent/mcp-client
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "i18n-agent": {
            "url": "https://mcp.i18nagent.ai/mcp"
        }
    }
}
```
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "i18n-agent": {
            "command": "npx",
            "args": [
                "-y",
                "@i18n-agent/mcp-client"
            ],
            "env": {
                "I18N_AGENT_API_KEY": "<I18N_AGENT_API_KEY>",
                "MCP_SERVER_URL": "<MCP_SERVER_URL>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "i18n-agent": {
            "type": "http",
            "url": "https://mcp.i18nagent.ai/mcp"
        }
    }
}
```
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "i18n-agent": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@i18n-agent/mcp-client"
            ],
            "env": {
                "I18N_AGENT_API_KEY": "<I18N_AGENT_API_KEY>",
                "MCP_SERVER_URL": "<MCP_SERVER_URL>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

1. **Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http i18n-agent https://mcp.i18nagent.ai/mcp
```

2. **Командой платформы**
```bash
gemini mcp add -e I18N_AGENT_API_KEY=<I18N_AGENT_API_KEY> -e MCP_SERVER_URL=<MCP_SERVER_URL> i18n-agent npx -y @i18n-agent/mcp-client
```
Вместо <…> подставьте свои значения

## Когда брать
- перевести JSON, сохранив вложенную структуру
- локализовать Markdown, не затрагивая кодовые блоки
- адаптировать текст для конкретного региона и аудитории
- проверить остаток кредитов на перевод
- узнать список языков и оценки качества

## Примеры запросов агенту
- Переведи этот JSON на французский, сохранив структуру и вложенные объекты.
- Локализуй текст для испанского языка Испании и непринуждённой аудитории.
- Покажи доступные языки перевода и оценки качества.

## Похожие
- [Serena MCP: the IDE for your agent](https://affpapa.org/nevibecode/mcp/serena-mcp-the-ide-for-your-agent.md) — MCP-сервер · ★ 30739
- [Compiler Explorer](https://affpapa.org/nevibecode/mcp/compiler-explorer.md) — MCP-сервер · ★ 19155
- [Claude Code Explorer MCP](https://affpapa.org/nevibecode/mcp/claude-code-explorer-mcp.md) — MCP-сервер · ★ 6236
- [Tolgee](https://affpapa.org/nevibecode/mcp/tolgee.md) — MCP-сервер · ★ 4140
- [jshookmcp](https://affpapa.org/nevibecode/mcp/jshookmcp.md) — MCP-сервер · ★ 2066
- [pyscn](https://affpapa.org/nevibecode/mcp/pyscn.md) — MCP-сервер · ★ 1097

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md