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

🧪 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

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

• TechWordTranslator API - The backend API

• FastMCP - FastMCP framework

• Anthropic MCP - Model Context Protocol specification