translatize

Name: translatize
Author: translatize.com

本地服务

github.com/Translatize开发工具01 周前更新

代码仓库

关于 translatize

translatize 是一组用于 Translatize 集成 API 的 TypeScript 工具，包含 SDK、用于同步翻译和分支管理的命令行工具，以及面向 AI Agent 的 MCP 服务。

主要功能

01用于集成 API 的 TypeScript SDK
02读取、搜索、编辑和分支管理标签
03拉取、推送和查看状态的命令行工具
04面向 AI Agent 的 MCP 服务
05GitHub 和 GitLab 的 CI 模板

适用场景

01读取和更新翻译标签
02通过 CI 工作流同步翻译
03向 AI Agent 提供翻译 API 操作

MCP 相关

@translatize/mcp 软件包提供 MCP 服务，通过标准输入输出向 AI Agent 暴露集成 API。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "com-translatize": {
      "command": "npx",
      "args": [
        "-y",
        "@translatize/mcp"
      ],
      "env": {
        "TRANSLATIZE_API_TOKEN": "<TRANSLATIZE_API_TOKEN>",
        "TRANSLATIZE_API_URL": "<TRANSLATIZE_API_URL>",
        "TRANSLATIZE_APP_URL": "<TRANSLATIZE_APP_URL>"
      }
    }
  }
}

启动命令npx -y @translatize/mcp

需要配置的环境变量

TRANSLATIZE_API_TOKEN密钥Translatize integration API token (an "mcni_..." string), bound to one project and branch. Create it under Project Settings -> Integrations at https://app.translatize.com.

TRANSLATIZE_API_URLAPI base URL including the /v1 segment. Defaults to https://api.translatize.com/v1.

TRANSLATIZE_APP_URLWeb-app base URL used to build review links. Defaults to https://app.translatize.com.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@translatize/mcp0.1.3stdio

工具

收录的工具列表 · 更新于 1 周前

此工具无需参数。

详细介绍

Translatize 集成

用于 Translatize 集成 API 的客户端工具（使用 Authorization: Bearer mcni_... 进行身份验证的机器令牌 API）。这是一个 npm 工作区根目录，与仓库中的应用有意分开——它是整个仓库中唯一包含 workspaces 的 package.json，仓库根目录则不包含 package.json。

软件包

软件包	目录	状态	说明
`@translatize/core`	`core/`	可用	用于集成 API 的零依赖 TypeScript SDK（客户端 + 扁平化/反扁平化辅助工具）。其他所有内容都基于此共享基础构建。
`@translatize/cli`	`cli/`	可用	基于 `@translatize/core` 构建的命令行工具（`translatize init/pull/push/status`）。通过类似 git 的分支管理方式，从 CI 同步翻译。
`@translatize/mcp`	`mcp/`	可用	基于 `@translatize/core` 构建的 Model Context Protocol 服务，通过 stdio 向 AI Agent（Claude Code、Cursor 等）公开 API。

CI 模板

两个开箱即用的 CI 集成与这些软件包相辅相成。它们通过 shell 调用 @translatize/cli（npx @translatize/cli ...），而非作为 npm 软件包提供，因此使用方式是将其配置为工作流/流水线，而不是通过 npm install 安装：

模板	主页	说明
GitHub Action	github.com/Translatize/sync-action	组合式 Action（`translatize/sync-action`），将 CLI 的 `pull`/`push`/`status` 封装起来，用于 GitHub 工作流。
GitLab CI	gitlab.com/translatize/gitlab	CI/CD Catalog 组件（`templates/translatize.yml`），以及可复制粘贴的 `.gitlab-ci.yml` 作业。

开发

cd integrations
npm install        # installs every workspace and hoists dev deps
npm run build      # builds each workspace that defines a build script
npm test           # runs each workspace's test suite

需要 Node.js >= 18.17（原生 fetch、node:test）。

发布

@translatize/core、@translatize/cli 和 @translatize/mcp 软件包发布至 npm 的 @translatize 作用域。发布需要手动进行——此处的内容不会自动发布。要发布新版本，请先构建，然后在各软件包目录中运行 npm publish --access public（或运行 npm publish --workspaces）。