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

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

• TechWordTranslator API - The backend API
• FastMCP - FastMCP framework
• Anthropic MCP - Model Context Protocol specification