MCP-Lingvanex-Translate

MCP Прототип – Сервер перевода

Этот проект реализует MCP (Model Context Protocol) сервер для перевода текста. Сервер поддерживает два транспорта:

• stdio – для интеграции с Claude Desktop
• http (streamable) – для тестирования и работы через HTTP + SSE

---

⚙️ Требования

• Node.js >= 18
• Yarn или npm
• Установленный Claude Desktop (для интеграции через stdio)
• Аккаунт Lingvanex Translator для перевода текста

---

🔑 Настройка Lingvanex Translator

Для использования Lingvanex Translator вам понадобится аккаунт Lingvanex.

1. Если у вас его нет, зарегистрируйтесь бесплатно

2. Перейдите на вкладку Cloud API: Cloud API

3. Заполните данные Платежного адреса

4. Нажмите Продолжить оплату

   • Для получения бесплатного пробного периода не обязательно добавлять платежную карту

5. Ваш API ключ будет сгенерирован и отображен на вкладке Cloud API: API ключ

Теперь вы готовы начать использовать API перевода. Ниже представлено видео-руководство по общему процессу (если доступно на сайте Lingvanex).

---

🚀 Установка и сборка

# Clone the repository
git clone https://github.com/lingvanex-mt/MCP-Lingvanex-Translate.git
cd mcp-prototype

Установка зависимостей

yarn install

---

🔌 Запуск в режиме stdio (Claude Desktop)

Режим stdio используется Claude Desktop для подключения к локальным MCP серверам.

Установите переменную окружения:

TRANSPORT=stdio

Запустите сервер:

yarn build
yarn start

Ожидаемый вывод:

MCP stdio transport running
Translate MCP Server ready

---

🌐 Запуск в режиме HTTP (streamable)

Режим http запускает локальный HTTP сервер с HTTP транспортом. Полезно для тестирования в браузере или с curl.

Установите переменные окружения:

TRANSPORT=http
HTTP_PORT=3000

Запустите сервер:

yarn build
yarn start

Протестируйте сервер:

curl http://127.0.0.1:3000/ping

Ожидаемый ответ:

{ "status": "ok", "transport": "http" }

Используйте MCP Inspector для отладки:

npx @modelcontextprotocol/inspector

В интерфейсе MCP Inspector выберите Transport Type - Streamable HTTP; URL - http://localhost:3000/mcp. Нажмите Connect.

---

🖥️ Интеграция с Claude Desktop

Claude Desktop обнаруживает локальные MCP серверы через файл конфигурации:

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

Пример конфигурации (Windows)

Откройте (или создайте) claude_desktop_config.json и добавьте:

{
  "mcpServers": {
    "translate": {
      "command": "node",
      "args": [
        "C:\\Users\\path\\to\\project\\dist\\index.js"
      ]
    }
  }
}

⚠️ Убедитесь, что вы обновили путь к вашему локальному dist/index.js после сборки!

---

✅ Как проверить

1. Запустите Claude Desktop.
2. Введите запрос, например: "Используй MCP инструмент translate_text чтобы перевести 'Hello world' на русский."
3. Если всё настроено правильно, Claude вызовет ваш MCP сервер и вернет перевод.

---

📌 Доступные инструменты

translate_text

Перевод текста с одного языка на другой.

Аргументы:

• text – текст для перевода
• sourceLang – код исходного языка (например, "en")
• targetLang – код целевого языка (например, "ru")

Пример запроса:

{
  "tool": "translate_text",
  "args": {
    "text": "Good morning",
    "sourceLang": "en",
    "targetLang": "fr"
  }
}

Пример ответа:

{
  "content": [
    { "type": "text", "text": "Bonjour" }
  ]
}

---