Supertext MCP Server

A Model Context Protocol (MCP) server for the Supertext API, allowing LLMs to perform translations, detect languages, and get quotes.

Prerequisites

• Node.js installed
• A Supertext API Key

Installation

1. Clone or download this repository.
2. Install dependencies:

   npm install

3. Create a .env file in the root directory and add your API key:

   SUPERTEXT_API_KEY=your_api_key_here
   PORT=3000 # Optional, default is 3000

Usage

1. Running as an HTTP Server (SSE)

This is the default mode. It exposes an SSE endpoint that MCP clients can connect to.

Start the server:

node index.js

The server will listen on http://localhost:3000.

MCP Configuration (for clients supporting URLs):

{
  "mcpServers": {
    "supertext": {
      "url": "http://localhost:3000/sse"
    }
  }
}

2. Using with Claude Desktop (Stdio)

Note: The current version is configured for HTTP/SSE. To use it with Claude Desktop (which uses Stdio), you would typically need to revert to the Stdio transport or use an adapter.

If you need Stdio support, you can modify index.js to use StdioServerTransport instead of SSEServerTransport and express.

Available Tools

• translate_text_ai: Translate text using AI.
• translate_text_fused: Translate text with human verification.
• detect_language: Detect the language of a text.
• get_quote_ai: Get a quote for AI translation.
• get_quote_fused: Get a quote for Fused translation.
• get_supported_languages: List supported languages.