使用说明
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分钟后起床跑步 |
| API 参考 | 所有5个MCP工具的完整文档 |
| Docker设置 | 详细的Docker配置指南 |
| 光标设置 | 与Cursor IDE集成 |
| 发展 | 开发人员指南和架构 |
| 测试 | 测试指南和覆盖范围 |
| 部署 | 生产部署选项 |
🛠️ 可用工具
服务器提供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 -模型上下文协议规范
