XLIFF MCP服务器
用于处理XLIFF和TMX翻译文件的MCP(模型上下文协议)服务器。此服务器提供用于解析、验证和操纵本地化工作流中常用的翻译文件的工具。
特性
- XLIFF处理:从XLIFF文件中解析和提取翻译单元
- TMX处理:从TMX文件中解析和提取翻译单元
- 标签保存:保留用于AI翻译的内联标签的特殊处理模式
- 验证:验证XLIFF和TMX文件格式
- 翻译替换:替换XLIFF文件中的目标翻译
- CSV/JSON导出:从XLIFF和TMX输入生成CSV或JSON文件内容
- 代理技能模块:提供独立
skills/AI代理可以直接读取的模块
安装
自动设置(推荐)
python setup.py手动安装
使用pip
pip install -e .使用安装脚本
./install.sh # Unix/Linux/macOS
install.bat # Windows配置
适用于克劳德桌面
将服务器添加到Claude Desktop配置文件中:
macOS/Linux: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %AppData%\Claude\claude_desktop_config.json
{
"mcpServers": {
"xliff-processor": {
"command": "python",
"args": ["-m", "xliff_mcp.server"],
"cwd": "/absolute/path/to/xliff-mcp-server"
}
}
}或者,如果使用紫外线:
{
"mcpServers": {
"xliff-processor": {
"command": "uv",
"args": ["run", "python", "-m", "xliff_mcp.server"],
"cwd": "/absolute/path/to/xliff-mcp-server"
}
}
}可用工具
processxliff
处理XLIFF内容并提取翻译单元。
参数:
file_name(string):XLIFF文件的名称content(string):XLIFF文件内容
退货: JSON,翻译单位包括:
- fileName、segNumber、unitId、百分比、源、目标、srcLang、tgtLang
带有标签的processxlif\_
处理XLIFF,保留内联标签以进行AI翻译。
参数:
file_name(string):XLIFF文件的名称content(string):XLIFF文件内容
退货: JSON,带有保留原始格式标签的翻译单元
validate_xliff
验证XLIFF内容格式。
参数:
content(string):要验证的XLIFF文件内容
退货: 带有验证状态、消息和单位计数的JSON
replacexlif_目标
替换XLIFF文件中的目标翻译。
参数:
content(string):原始XLIFF文件内容translations(string):带有segNumber/unitId和aiResult/mtResult的JSON转换数组
退货: 带有更新的XLIFF内容和替换计数的JSON
process_tmx
处理TMX内容并提取翻译单元。
参数:
file_name(string):TMX文件的名称content(string):TMX文件内容
退货: JSON,带有翻译单位,包括元数据
validate_tmx
验证TMX内容格式。
参数:
content(string):要验证的TMX文件内容
退货: 带有验证状态和单位计数的JSON
exportxlif_文件
从XLIFF文件生成CSV或JSON文件内容。
参数:
file_name(string):源XLIFF文件的名称content(string):XLIFF文件内容output_format(字符串):csv或jsonpreserve_tags(boolean):导出前是否保留内联标签
退货: JSON生成 file_name, mime_type, content,以及 unit_count
export_tmx文件
从TMX文件生成CSV或JSON文件内容。
参数:
file_name(string):源TMX文件的名称content(string):TMX文件内容output_format(字符串):csv或json
退货: JSON生成 file_name, mime_type, content,以及 unit_count
可用技能
技能与MCP运行时及其工具是分开的。
- MCP运行时:The
xliff_mcp/公开工具、提示和资源的包 - 代理技能模块:顶级
skills/AI代理可以直接读取的目录 - 运行时工作流注册:The
xliff_mcp/workflows/将工作流指导映射到MCP提示/资源的包
运行时仍然通过以下方式公开工作流指导:
- 提示:可重复使用的工作流提示,指导客户完成正确的工具顺序
- 资源:可发现的技能目录,网址为
skills://catalog以及每项技能的详细资源skills://{skill_name}
对于存储库中的代理使用:
- 从...开始 技能/README.md
- 使用 skills/catalog.json 作为机器可读的索引
- 打开引用的技能markdown文件以获取详细的工作流程说明
翻译准备.xliff
验证XLIFF内容,提取翻译单位,并总结翻译准备情况。
translate_xliff_带标签
提取保留标签的XLIFF段,并在不破坏内联标记的情况下指导AI翻译。
replacexlif_targets_from_translations
将翻译后的段JSON合并回原始XLIFF,并验证替换计数。
inspect_tmx_translation_memory
验证TMX内容,检查语言对,并总结翻译记忆库条目以供重用。
用法示例
在Claude Desktop中配置后,您可以使用以下工具:
- 处理XLIFF文件:
“请处理此XLIFF文件并向我显示翻译单位”
- 验证XLIFF格式:
“您能验证此XLIFF内容的格式是否正确吗?”
- 替换翻译:
“用这些新翻译替换此XLIFF文件中的目标翻译”
- 处理TMX文件:
“从该TMX文件中提取所有翻译单元”
- 生成CSV导出:
“将此XLIFF文件导出为CSV,并给我文件内容”
- 生成JSON导出:
“将此TMX文件导出为JSON,以便我可以将其保存在本地”
- 使用运行时工作流提示:
“使用 translate_xliff_with_tags 提示帮助我安全翻译此XLIFF”
发展
运行棉绒
ruff check .运行测试
python -m pytest运行烟雾测试脚本
python test_server.py直接运行服务器
python -m xliff_mcp.server需求
- Python 3.10+
- mcp>=1.2.0
- 翻译工具包>=3.0.0
- lxml >= 4.9.0
- 媒染剂>=2.0.0
许可证
麻省理工学院
支持
有关问题和疑问,请在GitHub存储库上打开问题。
