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

⚙️ Requirements

• Node.js >= 18

• Yarn or npm

• Installed Claude Desktop (for stdio integration)

• Lingvanex Translator account for text translation

🔑 Lingvanex Translator Setup

To use the Lingvanex Translator you'll need a Lingvanex account.

1. If you don't have one, sign up for free

2. Go to the Cloud API tab: Cloud API

3. Fill out the Billing Address data

4. Click Continue to payment

   • To get a free trial, it is not necessary to add your payment card

5. Your API key will be generated and visible in the Cloud API tab: API key

Now you are ready to start using the translation API. Below is a video tutorial of the overall process (if available on Lingvanex site).

🚀 Installation & Build

Install dependencies

🔌 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:

Expected output:

🌐 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:

Start the server:

Test the server:

Expected response:

Use MCP Inspector for debugging:

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:

⚠️ 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

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:

Example response: