Tech Word Translator MCP Server

TechWord翻译器MCP服务器

一个公共模型上下文协议（MCP）服务器，为英语、西班牙语和德语的技术术语提供翻译服务。采用FastMCP构建，由 TechWordTranslator API.

✨ 特性

• 🌍 多语言翻译：在英语、西班牙语和德语之间翻译技术术语
• 🔍 智能搜索：搜索部分匹配的技术术语
• 📚 综合数据库：访问精心策划的IT和技术术语数据库
• ⚡ 快速高效：基于FastMCP构建，带有异步HTTP客户端
• 🔌 易于集成：适用于Claude Desktop、Cursor和其他MCP客户端
• ✅ 生产就绪：全面的测试套件，高覆盖率，企业级质量

🧪 测试

./run-tests.sh

看 docs/testing.md 了解详情。

🚀 快速开始

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

📖 文档

🛠️ 可用工具

服务器提供5个MCP工具用于技术术语翻译和搜索。请参阅 API 参考 了解完整细节。

• translate_term -将一个技术术语从一种语言翻译成另一种语言
• search_tech_terms -在数据库中搜索技术术语
• get_all_translations -获取一个术语的所有可用翻译
• get_term_details -获取特定术语的详细信息
• list_tech_terms -列出带页码的技术术语

🔧 整合

克劳德桌面版

添加到您的 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

查看完整 光标设置指南 用于集成步骤。

🏗️ 建筑

遵循SOLID原则，采用简洁的模块化架构构建：

• 模型/ -领域模型(Word, TranslationItem)
• 服务/ -业务逻辑(APIClient, SearchService, TranslatorService)
• formatters.py -响应格式化实用程序
• tools.py -所有5个MCP工具实现
• container.py -服务单例生命周期（依赖容器）
• 服务器.py -精简入口点：注册工具并启动MCP服务器

📋 需求

• Docker（推荐）或Python 3.12+
• TechWordTranslator API实例

环境变量

• TECHWORD_TRANSLATOR_API_URL -TechWordTranslator API的基本URL（必需）

📄 许可证

此项目根据GNU通用公共许可证v3.0获得许可-请参阅 许可证 文件以获取详细信息。

🙏 致谢

• TechWordTranslator API -后端API
• FastMCP -FastMCP框架
• 人类MCP -模型上下文协议规范