Skip to main content
Glama
TechWord Translator MCP Server

TechWord Translator MCP Server

by josego85

TechWord Translator MCP Server

A public Model Context Protocol (MCP) server that provides translation services for technical terms across English, Spanish, and German. Built with FastMCP and powered by the TechWordTranslator API.

✨ Features

  • 🌍 Multi-language Translation: Translate technical terms between English, Spanish, and German

  • πŸ” Smart Search: Search for technical terms with partial matching

  • πŸ“š Comprehensive Database: Access to a curated database of IT and technology terminology

  • ⚑ Fast & Efficient: Built on FastMCP with async HTTP client

  • πŸ”Œ Easy Integration: Works with Claude Desktop, Cursor, and other MCP clients

  • βœ… Production Ready: Comprehensive test suite, high coverage, enterprise-grade quality

Related MCP server: DialectOS

πŸ§ͺ Testing

./run-tests.sh

See docs/testing.md for details.

πŸš€ Quick Start

# Build and run with Docker Compose
docker compose build
docker compose run --rm -e TECHWORD_TRANSLATOR_API_URL=http://localhost:8000 techword-mcp

πŸ“– Documentation

Guide

Description

Quickstart

Get up and running in 5 minutes

API Reference

Complete documentation of all 5 MCP tools

Docker Setup

Detailed Docker configuration guide

Cursor Setup

Integrate with Cursor IDE

Development

Developer guide and architecture

Testing

Testing guide and coverage

Deployment

Production deployment options

πŸ› οΈ Available Tools

The server provides 5 MCP tools for technical term translation and search. See the API Reference for complete details.

  • translate_term - Translate a technical term from one language to another

  • search_tech_terms - Search for technical terms in the database

  • get_all_translations - Get all available translations for a term

  • get_term_details - Get detailed information about a specific term

  • list_tech_terms - List technical terms with pagination

πŸ”§ Integration

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "techword-translator": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i", "--network=host",
        "-e", "TECHWORD_TRANSLATOR_API_URL=http://localhost:8000",
        "techword-mcp"
      ]
    }
  }
}

Cursor IDE

See the complete Cursor Setup Guide for integration steps.

πŸ—οΈ Architecture

Built following SOLID principles with a clean, modular architecture:

  • models/ - Domain models (Word, TranslationItem)

  • services/ - Business logic (APIClient, SearchService, TranslatorService)

  • formatters.py - Response formatting utilities

  • tools.py - All 5 MCP tool implementations

  • container.py - Service singleton lifecycle (dependency container)

  • server.py - Thin entry point: registers tools and starts the MCP server

πŸ“‹ Requirements

  • Docker (recommended) or Python 3.12+

  • TechWordTranslator API instance

Environment Variables

  • TECHWORD_TRANSLATOR_API_URL - Base URL of the TechWordTranslator API (required)

πŸ“„ License

This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.

πŸ™ Acknowledgments

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      B
      maintenance
      Spanish dialect localization MCP server and CLI. It translates and QA-checks content across 25 regional variants with register control, structure preservation, and adversarial quality gates.
      16
      4
      Apache 2.0
    • A
      license
      A
      quality
      B
      maintenance
      Translate PDF, Word (DOCX), Excel (XLSX) and PowerPoint (PPTX) files, images, subtitles and text. Turn audio and video into transcripts or translated subtitles. Preserve layout where supported. Requires an Equalang API key and credits.
      8
      78 npm
      22
      Apache 2.0