MCP 翻译服务
基于小牛翻译(Niutrans)API 的 MCP Provider,提供文字翻译工具和语种目录资源,方便在 Cursor/mcp-cli 等客户端中引用。
快速开始
使用 uv 安装并启动发布版
环境变量
NIUTRANS_API_KEY(必填):小牛翻译开放平台提供的 API Key,可免费使用, 请登录后获取:https://niutrans.com/cloud/account_info/info
MCP 客户端配置示例
若通过 uv tool install 安装,可在 mcp.json 中写:
启动 Cursor 后执行 ListTools 即可看到 translate_text,同时支持 ListResources 读取 language://catalog。
可用功能
工具:translate_text
参数:
text:待翻译内容。source:源语言代码或别名(会通过本地映射表规范化)。target:目标语言代码或别名。
返回:
{ "source": "zh", "target": "en", "original_text": "你好", "translated_text": "Hello", "raw": { ... 小牛原始响应 ... } }
资源:language://catalog
提供所有可用语种及别名,示例如下:
推荐在客户端的 LLM 中先读取该资源,完成语种描述到代码的映射后,再调用 translate_text。
调试与常见问题
缺少 API Key:启动时报
缺少环境变量 NIUTRANS_API_KEY,请确认已在.env或系统环境中设置。语种不支持:
translate_text会校验语种代码/别名,若报错请检查是否使用了language://catalog中列出的值。路径或依赖问题:脚本依赖
uv,请先安装pip install uv或参考 uv 文档。命令名称:通过 PyPI 安装后,可直接运行
mcp-translation-text;若 global PATH 中找不到,记得激活虚拟环境或使用python -m mcp_translation_text。发布/升级包:
python -m build twine upload dist/*
目录结构(关键文件)
发布后,用户只需设置 Niutrans API Key,即可通过 mcp-translation-text 直接加载该 Provider。