Labsco
lingvanex-mt logo

MCP-Lingvanex-Translate

from lingvanex-mt

Lingvanex MCP Server Cloud API โ€“ A Model Context Protocol server that provides fast and accurate text translation using the Lingvanex Cloud API. Supports 100+ languages and integrates seamlessly with Claude Desktop and other MCP-compatible clients.

๐Ÿ”ฅ๐Ÿ”ฅ๐Ÿ”ฅโœ“ VerifiedFreeAdvanced setup

MCP Prototype โ€“ Translate Server

This project implements an MCP (Model Context Protocol) server for text translation. The server supports two transports:

  • stdio โ€“ for integration with Claude Desktop
  • http (streamable) โ€“ for testing and working via HTTP + SSE

๐Ÿ”Œ Run in stdio mode (Claude Desktop)

stdio mode is used by Claude Desktop to connect to local MCP servers.

Set environment variable:

TRANSPORT=stdio

Start the server:

yarn build
yarn start

Expected output:

MCP stdio transport running
Translate MCP Server ready

๐ŸŒ Run in HTTP mode (streamable)

http mode runs a local HTTP server with HTTP transport. Useful for browser testing or with curl.

Set environment variables:

TRANSPORT=http
HTTP_PORT=3000

Start the server:

yarn build
yarn start

Test the server:

curl http://127.0.0.1:3000/ping

Expected response:

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

Use MCP Inspector for debugging:

npx @modelcontextprotocol/inspector

In the MCP Inspector UI, select Transport Type - Streamable HTTP; URL - http://localhost:3000/mcp. Click Connect.


๐Ÿ–ฅ๏ธ Integration with Claude Desktop

Claude Desktop discovers local MCP servers via config file:

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

Example config (Windows)

Open (or create) claude_desktop_config.json and add:

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

โš ๏ธ Make sure to update the path to your local dist/index.js after build!


โœ… How to verify

  1. Launch Claude Desktop.
  2. Enter a request like: "Use the MCP tool translate_text to translate 'Hello world' into Russian."
  3. If everything is configured correctly, Claude will call your MCP server and return the translation.

๐Ÿ“Œ Available Tools

translate_text

Translate text from one language into another.

Arguments:

  • text โ€“ the text to translate
  • sourceLang โ€“ source language code (e.g. "en")
  • targetLang โ€“ target language code (e.g. "ru")

Example request:

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

Example response:

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