MCP-Lingvanex-Translate Server

oficial

Servidor MCP de Lingvanex Cloud API – Un servidor de Protocolo de Contexto de Modelo que proporciona traducción de texto rápida y precisa utilizando la API en la nube de Lingvanex. Soporta más de 100 idiomas y se integra sin problemas con Claude Desktop y otros clientes compatibles con MCP.

GitHub

Documentación

MCP Prototype – Servidor de traducción

Este proyecto implementa un servidor MCP (Model Context Protocol) para traducción de texto. El servidor admite dos transportes:

  • stdio – para integración con Claude Desktop
  • http (transmisible) – para pruebas y trabajo vía HTTP + SSE

⚙️ Requisitos

  • Node.js >= 18
  • Yarn o npm
  • Claude Desktop instalado (para integración stdio)
  • Cuenta de Lingvanex Translator para traducción de texto

🔑 Configuración de Lingvanex Translator

Para usar Lingvanex Translator necesitarás una cuenta de Lingvanex.

  1. Si no tienes una, regístrate gratis
  2. Ve a la pestaña Cloud API: Cloud API
  3. Rellena los datos de Dirección de facturación
  4. Haz clic en Continuar al pago
    • Para obtener una prueba gratuita, no es necesario añadir tu tarjeta de pago
  5. Tu clave API se generará y será visible en la pestaña Cloud API: clave API

Ahora estás listo para empezar a usar la API de traducción. A continuación hay un videotutorial del proceso general (si está disponible en el sitio de Lingvanex).

🚀 Instalación y compilación

Clonar el repositorio

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

Instalar dependencias

yarn install

🔌 Ejecutar en modo stdio (Claude Desktop)

El modo stdio lo usa Claude Desktop para conectarse a servidores MCP locales.

Establecer variable de entorno:

TRANSPORT=stdio

Iniciar el servidor:

yarn build yarn start

Salida esperada:

MCP stdio transport running
Translate MCP Server ready

🌐 Ejecutar en modo HTTP (transmisible)

El modo http ejecuta un servidor HTTP local con transporte HTTP. Útil para pruebas en navegador o con curl.

Establecer variables de entorno:

TRANSPORT=http HTTP_PORT=3000

Probar el servidor:

curl http://127.0.0.1:3000/ping

Respuesta esperada:

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

Usar MCP Inspector para depuración:

npx @modelcontextprotocol/inspector

En la interfaz de MCP Inspector, selecciona Tipo de transporte - HTTP transmisible; URL - http://localhost:3000/mcp. Haz clic en Conectar.

🖥️ Integración con Claude Desktop

Claude Desktop descubre servidores MCP locales mediante un archivo de configuración:

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

Ejemplo de configuración (Windows)

Abre (o crea) claude_desktop_config.json y añade:

{ "mcpServers": { "translate": { "command": "node", "args": [ "C:\Users\ruta\al\proyecto\dist\index.js" ] } } }

⚠️ ¡Asegúrate de actualizar la ruta a tu dist/index.js local después de la compilación!

✅ Cómo verificar

  1. Inicia Claude Desktop.
  2. Introduce una solicitud como:"Usa la herramienta MCP translatetext para traducir 'Hello world' al ruso."
  3. Si todo está configurado correctamente, Claude llamará a tu servidor MCP y devolverá la traducción.

📌 Herramientas disponibles

translate_text

Traduce texto de un idioma a otro.

Argumentos:

  • text – el texto a traducir
  • sourceLang – código del idioma de origen (p. ej. "en")
  • targetLang – código del idioma de destino (p. ej. "ru")

Ejemplo de solicitud:

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

Ejemplo de respuesta:

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