关于 equalang-mcp
equalang-mcp 将 MCP 客户端连接到 Equalang,用于翻译文件、媒体和文本,或转录录音。文档以原格式返回,并保留表格、图片和公式等版面元素。
主要功能
- 01翻译文档并保留格式与版面
- 02翻译定时字幕和图片文字
- 03从媒体生成译制字幕或转录文本
- 04批量翻译短文本
- 05检测源语言并列出支持语言
- 06估算费用并管理任务
适用场景
- 01翻译 PDF 或演示文稿并保留版面
- 02从视频制作其他语言的字幕
- 03转录带时间戳的录音
- 04启动前估算文件翻译任务费用
MCP 相关
该 MCP 服务将 Equalang 的翻译和转录操作作为工具提供,包括文件翻译、任务管理、语言列表和额度查询。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
8收录的工具列表 · 更新于 2 周前
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| source | string | 否 | 文件:此计算机上的绝对路径,或公共 http(s) URL(由 Equalang 获取,不会在此处下载)。传入 file_id 时省略。 |
| file_id | string | 否 | 由 estimate_cost 上传的文件;使用此参数代替 source,可在不重新上传的情况下启动任务。 |
| bilingual | boolean | 否 | 仅限字幕和录音:在每条译文上方保留对应的原文行。 |
| output_dir | string | 否 | 结果目录。默认为本地源文件所在目录。URL 源没有“同级目录”;不设置此参数时,回答中会包含临时链接。 |
| wait_seconds | number | 否 | 等待的秒数;超时后改为返回 job_id(默认 50,最多 240)。 |
| output_formats | array | 否 | 仅限录音:要写入的格式(默认 srt)。 |
| source_language | string | 否 | 文件的语言;省略则自动检测。 |
| target_language | string | 是 | 要翻译成的语言。语言代码示例:en、zh-CN、zh-TW、ja、ko、es、fr、de。list_languages 提供可用代码;文件支持的代码少于文本。 |
详细介绍
equalang-mcp
English · 简体中文 · 日本語 · 한국어 · Español · Français · Deutsch · Português · Italiano · Русский · Polski · Türkçe · Tiếng Việt · Bahasa Indonesia · ไทย · हिन्दी · العربية
关键词: 文档翻译、PDF 翻译器、翻译 PDF 并保留布局、DOCX 翻译、PPTX 翻译、Excel 翻译、EPUB 翻译、字幕翻译、SRT 翻译器、图片翻译、视频翻译、音频转录、语音转文字、AI 翻译器、MCP 服务、模型上下文协议、Claude MCP、Cursor MCP、翻译 API
翻译文件,保留布局。 这是一个适用于 Equalang 的 MCP 服务。Equalang 是一款可处理完整文件的 AI 翻译器:PDF 翻译后仍是 PDF,演示文稿翻译后仍是演示文稿,表格、图片和公式都保留原位。它还可以翻译字幕和图片,将音频和视频转换为翻译后的字幕或转录文本,并批量翻译短文本。可在 Claude Code、Claude Desktop、Codex、Cursor、Windsurf、Cline、VS Code 及其他所有 MCP 客户端中使用。
claude mcp add equalang -s user -e EQUALANG_API_KEY=el_your_key -- npx -y @equalang/mcp
试着这样询问
- “将 ~/Documents/contract.pdf 翻译成中文,并保留布局。”
- “将 pitch-deck.pptx 翻译成日语和德语。”
- “将 https://example.com/whitepaper.pdf 翻译成西班牙语,并保存到 ~/Downloads。”
- “将 thesis.docx 翻译成法语需要多少钱?”
- “为 interview.mp4 制作韩语字幕,并在每行字幕上方显示原文。”
- “转录 standup.m4a,并添加时间戳。”
- “制作 menu.jpg 的英文版本。”
- “将 novel.epub 翻译成英语。”
功能
- 文档 - PDF、DOCX、PPTX、XLSX、EPUB、HTML 和 TXT 翻译后仍为原格式,可继续编辑,表格、图片、公式和页面布局均保留原样
- 字幕和图片 - SRT 和 VTT 保留时间信息,也可选择在译文上方显示原文;JPG、PNG、WebP 和 BMP 翻译后会保留图片中的文字
- 音频和视频 - MP3、M4A、WAV、FLAC、OGG、AAC、Opus、MP4、MOV、WebM 和 MKV 可转换为翻译后的字幕,或转换为音频所用语言的转录文本(SRT、VTT、TXT、JSON)
- 批量文本 - 按顺序翻译短文本,或翻译一段长文本(最多 100,000 个字符),Equalang 会自行按句子切分
- 语言 — 文本和文档支持 152 种语言;实时语言列表反映当前部署情况。省略源语言即可自动检测。
- PDF 公式 — 公式优化为可选功能,默认关闭。仅适用于 PDF 文件。
translate_file→optimize_math_formula: true按默认费率,每个原始 PDF 页面额外收取 10 个积分。估算费用时使用相同选项。estimate_cost→optimize_math_formula: true
获取密钥
在 https://equalang.com 注册,并在 https://equalang.com/api-keys 创建密钥。新账户会获得免费额度,足以处理一份文档。
将密钥放入 MCP 客户端配置的环境变量中,绝不要放进 URL。没有密钥时,服务仍会启动并列出其工具;需要密钥的工具会告知如何获取密钥。
也可以将密钥保存在每台机器的 ~/.config/equalang/.env 中;Equalang 技能也会读取该文件:
# Replace el_your_key with your key
mkdir -p ~/.config/equalang && echo 'EQUALANG_API_KEY=el_your_key' > ~/.config/equalang/.env && chmod 600 ~/.config/equalang/.env
服务会优先从环境中读取 EQUALANG_API_KEY,只有在环境中没有密钥时才读取该文件:客户端配置中的密钥优先;如果已创建该文件,客户端配置就不需要 env。
安装
需要 Node 18 或更高版本。
Claude Code
claude mcp add equalang -s user -e EQUALANG_API_KEY=el_your_key -- npx -y @equalang/mcp
-s user 会将其添加到每个项目;默认范围 local 只会在运行该命令的目录中加载服务。
OpenAI Codex
codex mcp add equalang --env EQUALANG_API_KEY=el_your_key -- npx -y @equalang/mcp
Claude Desktop、Cursor、Windsurf、Cline 和其他使用 JSON 配置的客户端
将以下内容添加到客户端的 MCP 配置中:claude_desktop_config.json、~/.cursor/mcp.json、~/.codeium/windsurf/mcp_config.json,或客户端文档中指定的文件:
{
"mcpServers": {
"equalang": {
"command": "npx",
"args": ["-y", "@equalang/mcp"],
"env": { "EQUALANG_API_KEY": "el_your_key" }
}
}
}
VS Code
code --add-mcp '{"name":"equalang","command":"npx","args":["-y","@equalang/mcp"],"env":{"EQUALANG_API_KEY":"el_your_key"}}'
更喜欢使用技能?equalang-skill 提供相同的操作,形式为 Agent Skill——只有一个 Python 脚本,无需安装。
工具
| 工具 | 功能 |
|---|---|
translate_file | 将文件(路径或公开 URL)翻译成另一种语言,并将结果保存在原文件旁边。 |
transcribe_recording | 将音频或视频文件中的内容转写为带时间码的文本(SRT、VTT、TXT、JSON)。 |
translate_text | 按顺序翻译短文本,或翻译一段长文本;Equalang 会自行按句子切分。 |
estimate_cost | 上传文件但不启动任何任务;返回处理该文件的最高费用,以及一个可在无需再次上传的情况下启动任务的 file_id。免费。 |
check_job | 重新获取任务,并在任务完成后保存结果。 |
cancel_job | 停止排队中或正在运行的任务。取消的任务不会收费。 |
get_credit_balance | 查看账户的额度。 |
list_languages | 列出所有语言代码和名称。无需密钥。 |
语言代码的形式如 en、zh-CN、ja;list_languages 会列出完整清单。任务需要几分钟;工具最多等待 wait_seconds(默认 50 s,最多 240 s),之后会返回任务 ID,供 check_job 获取结果。
链接
- Equalang · 定价 · 开发者文档
- 面向 Agent 的 API:llms.txt · llms-full.txt · OpenAPI
- equalang-skill - 提供相同操作的 Agent Skill
- 问题咨询:[email protected]
许可证
Apache-2.0 © Equalang
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。