MCP-Lingvanex-Translate Server

oficial

Servidor MCP Lingvanex Cloud API – Um servidor de protocolo de contexto de modelo que fornece tradução de texto rápida e precisa usando a Lingvanex Cloud API. Suporta mais de 100 idiomas e integra-se perfeitamente com o Claude Desktop e outros clientes compatíveis com MCP.

GitHub

Documentação

Protótipo MCP – Servidor de Tradução

Este projeto implementa um servidor MCP (Model Context Protocol) para tradução de texto. O servidor oferece suporte a dois transportes:

  • stdio – para integração com o Claude Desktop
  • http (streamable) – para testes e trabalho via HTTP + SSE

⚙️ Requisitos

  • Node.js >= 18
  • Yarn ou npm
  • Claude Desktop instalado (para integração stdio)
  • Conta no Lingvanex Translator para tradução de texto

🔑 Configuração do Lingvanex Translator

Para usar o Lingvanex Translator, você precisará de uma conta Lingvanex.

  1. Se não tiver uma, cadastre-se gratuitamente
  2. Acesse a aba Cloud API: Cloud API
  3. Preencha os dados de Billing Address
  4. Clique em Continue to payment
    • Para obter um teste gratuito, não é necessário adicionar um cartão de pagamento
  5. Sua API key será gerada e ficará visível na aba Cloud API: API key

Agora você está pronto para começar a usar a API de tradução. Abaixo há um tutorial em vídeo do processo geral (se disponível no site da Lingvanex).

🚀 Instalação e Build

Clone o repositório

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

Instale as dependências

yarn install

🔌 Executar no modo stdio (Claude Desktop)

O modo stdio é usado pelo Claude Desktop para conectar-se a servidores MCP locais.

Defina a variável de ambiente:

TRANSPORT=stdio

Inicie o servidor:

yarn build yarn start

Saída esperada:

MCP stdio transport running
Translate MCP Server ready

🌐 Executar no modo HTTP (streamable)

O modo http executa um servidor HTTP local com transporte HTTP. Útil para testes no navegador ou com curl.

Defina as variáveis de ambiente:

TRANSPORT=http HTTP_PORT=3000

Teste o servidor:

curl http://127.0.0.1:3000/ping

Resposta esperada:

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

Use o MCP Inspector para depuração:

npx @modelcontextprotocol/inspector

Na interface do MCP Inspector, selecione Transport Type - Streamable HTTP; URL - http://localhost:3000/mcp. e clique em Connect.

🖥️ Integração com o Claude Desktop

O Claude Desktop descobre servidores MCP locais por meio de um arquivo de configuração:

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

Exemplo de configuração (Windows)

Abra (ou crie) claude_desktop_config.json e adicione:

{ "mcpServers": { "translate": { "command": "node", "args": [ "C:\Users\caminho\para\projeto\dist\index.js" ] } } }

⚠️ Certifique-se de atualizar o caminho para o seu dist/index.js local após o build!

✅ Como verificar

  1. Inicie o Claude Desktop.
  2. Insira uma solicitação como:"Use a ferramenta MCP translatetext para traduzir 'Hello world' para russo."
  3. Se tudo estiver configurado corretamente, o Claude chamará seu servidor MCP e retornará a tradução.

📌 Ferramentas Disponíveis

translate_text

Traduz texto de um idioma para outro.

Argumentos:

  • text – o texto a ser traduzido
  • sourceLang – código do idioma de origem (ex.: "en")
  • targetLang – código do idioma de destino (ex.: "ru")

Exemplo de solicitação:

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

Exemplo de resposta:

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