Translate

Translate — 兼容 LibreTranslate 的机器翻译

通过任意兼容 LibreTranslate 的实例翻译文本、检测语言或列出支持的语言。

属于 Pipeworx — 一个将 AI Agent 连接到 1684+ 个实时数据源的 MCP 网关。

你需要自备实例或密钥。 如需无需自备密钥即可使用的翻译服务，请使用 deepl — deepl_translate 支持相同的语言，且 Pipeworx 会提供密钥。

工具

工具	功能
translate	在两种语言之间翻译文本
detect_language	检测字符串的语言，并提供置信度
list_languages	列出配置的实例支持的语言代码

身份验证

任选其一，自备以下内容：

• _apiKey — 从 https://portal.libretranslate.com 获取的 API 密钥（libretranslate.com 现在仅支持密钥）
• _endpoint — 可自托管实例的基础 URL（https://github.com/LibreTranslate/LibreTranslate）

如果两者都未提供，每个工具都会返回 {found: false, reason: "requires_key_or_endpoint"}，并指向 deepl_translate。工具不会尝试发起调用。

为何需要门控

这个工具包过去会将 libretranslate.com 硬编码，并在不使用密钥的情况下调用它。该端点现已改为需要 API 密钥，因此每次调用都会返回上游的原始 400 错误 — “请访问 portal.libretranslate.com 获取 API 密钥” — 这会让调用方误以为 Pipeworx 出了问题，而不是该数据源需要密钥。

显而易见的替代方案是使用免费的公共镜像，但现在已没有可用的镜像。检查日期：2026-08-06：

实例	结果
translate.argosopentech.com	无法解析
libretranslate.com	400，需要密钥
translate.terraprint.co	502
lt.vern.cc	502
translate.fedilab.app	403
libretranslate.eownerdead.dedyn.io	403
trans.zillyhuhn.com	403

因此，这个工具包会如实要求自备资源，而不是暗中处于不可用状态。它已在网关的 BYO_ONLY_KEY_PACKS 中注册，这会使它在路由中的优先级低于 deepl_translate，并为其添加标记，这样 Agent 请求翻译内容时就会调用能够响应的工具。

数据源

LibreTranslate API v1 — https://github.com/LibreTranslate/LibreTranslate#api

快速开始

将其添加到 MCP 客户端（Claude Desktop、Cursor、Windsurf 等）：

{
  "mcpServers": {
    "translate": {
      "url": "https://gateway.pipeworx.io/translate/mcp"
    }
  }
}

此端点实际提供的内容

https://gateway.pipeworx.io/translate/mcp 上的 tools/list 会返回上表中的工具，以及共享的 Pipeworx 元工具 — ask_pipeworx、 discover_tools、search_within、remember/recall 和网关全局工具集中的其他工具。因此，你看到的工具数量会多于表中所列：单工具包端点目前会在该工具包自带的工具之外，列出大约 30 个共享工具。连接的 initialize 响应会说明其确切范围，并且是当日情况的权威依据。

这是有意设计的，并非意外复用。这些元工具使受限连接能够通过 ask_pipeworx 回答该工具包未覆盖的问题 — ask_pipeworx 会跨整个目录进行路由 — 无需你再添加第二个 MCP 服务。目前无法挂载不含这些工具的工具包端点；如果额外的架构信息占用的上下文多于路由带来的收益，请改为连接一次完整网关，而不是连接多个工具包端点。

或者，连接完整的 Pipeworx 网关，直接列出所有工具包的工具，而不只是这个工具包的工具：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

两个 URL 都连接到相同的网关和相同的 1684+ 个数据源。唯一的区别是直接列出哪个工具包的工具；从任意一个端点都可以通过 ask_pipeworx 访问所有工具。

没有 MCP 客户端？通过 HTTP 调用

这个工具包需要你自备 API 密钥（_apiKey）— 我们不会为它提供密钥，因此没有无需密钥即可运行的 curl 命令。查看任意工具：GET https://gateway.pipeworx.io/v1/tools/translate_translate。查找工具包：使用 POST https://gateway.pipeworx.io/v1/tools/search_packs，并传入 {"query":"..."}。

独立运行（无需 gateway 账号）

此软件包也可作为本地 stdio MCP 服务运行，无需 Pipeworx 账号，也无需经过网关往返：

{
  "mcpServers": {
    "translate": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-translate"]
    }
  }
}

或者直接运行，确认它可以启动：

npx -y @pipeworx/mcp-translate

它通过 stdin/stdout 使用 MCP 通信，并响应 initialize/tools/list/tools/call，仅提供此软件包中的工具，不包含上方网关连接额外提供的任何共享元工具。使用相同的源代码和工具，无需 ask_pipeworx 路由。

使用 ask_pipeworx

你可以用通俗的英语提问，而不是直接调用工具——这既适用于上方的软件包端点，也适用于完整网关：

ask_pipeworx({ question: "your question about Translate data" })

网关会选择合适的工具并自动填入参数。

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT