Tolgee

io.github.tolgee由 GitHub 账号 tolgee 发布v1.0.0更新于 Oct 24, 2026

Your app's translations in Tolgee: search keys, create translations, trigger machine translation

已验证Streamable HTTP可网页运行效率与工作流开发者工具

概览

AI 生成的概览

Tolgee 托管的 MCP 服务器让 AI 助手管理本地化项目：搜索和创建翻译键、设置译文并触发机器翻译。

可以做什么
  • 列出和创建项目，查看各语言的翻译进度统计
  • 列出、搜索、创建、更新和删除翻译键，读取键的元数据
  • 获取并设置键在各项目语言下的译文
  • 列出和添加语言，列出命名空间，列出标签并给键打标签
  • 为指定键启动机器翻译，并轮询批处理任务状态
  • 列出、创建和删除项目分支（需企业版分支功能）
适用场景
适合在使用 Tolgee 做本地化的应用开发中，让助手在不离开编辑器的情况下查找翻译键、补充或修改译文、添加语言或标签，或启动机器翻译。
运行要求
需要远程 MCP 端点 app.tolgee.io（或自建实例）、可访问目标项目的 Tolgee 账号，以及通过 X-API-Key 请求头传入的 API 密钥（个人访问令牌或项目 API 密钥）。
安装前请注意
该 API 密钥可访问你的 Tolgee 项目，应最小化授权并妥善保管。删除键和分支属于破坏性操作，服务器要求助手先与你确认。创建键、设置译文、打标签和机器翻译都会修改项目数据，机器翻译还可能消耗 Tolgee 中配置的付费翻译服务额度。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Tolgee，将其添加到工作区。
  2. 连接 X-API-Key 凭据。它们会被私密存储，绝不会在公开页面上展示。
  3. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.tolgee%2Ftolgee/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "tolgee": {
      "type": "http",
      "url": "https://app.tolgee.io/mcp/developer",
      "headers": {
        "X-API-Key": "<YOUR_API_KEY>"
      }
    }
  }
}

README

Tolgee
 An open-source localization platform
developers enjoy working with

[Tolgee]

Why use Tolgee?

It saves you valuable time that would otherwise be spent on localization tasks while ensuring your software is flawlessly translated.

[Frame 47]

In context translating & One click screenshots

Easily add translations to your code and edit them directly within your app using the Tolgee i18n tool. Simply hold the ALT/Option key and click on an element to open a dialog where you can modify your strings effortlessly—no need to navigate through bulky .json/.po/.whatever files. Plus, in-context translation works seamlessly even in the production environment.

Just one click—that’s all it takes to capture a screenshot of your application with highlighted phrases for translation. Simply hold ALT + click on a string, then hit the camera button. Boom! Your screenshot is instantly generated.

[Tolgee in-context editing]

Translating on production

In-context translation works seamlessly even in the production environment of your deployed app. With the Tolgee Tools Chrome plugin, simply enter your API key and start translating—no coding skills required. This makes it easy for anyone to contribute to your app’s translations effortlessly.

True integrations

Tolgee isn't just another localization platform that simply syncs your local data with a backend. Instead, it seamlessly integrates into your app through powerful SDKs, providing a truly embedded translation experience.

Machine translation

We support DeepL, Google Translate, AWS Translate, and Azure Translator—simply choose your preferred services in the settings. With machine translation, the localization process becomes significantly faster, allowing translators to leverage AI-powered suggestions for more efficient and accurate translations.

AI translator

Conventional machine translation sees one string at a time. The AI translator sees the situation around it: screenshots of the phrase in your app, the key and project descriptions, your language notes, matches from the translation memory, and Tolgee Context, which the SDK gathers from how keys are actually laid out in your application.

The result is that ambiguous strings stop being a coin flip. A bare "Open" can be a button, a status or a menu item, and the AI translator picks based on where it appears—then tells you which reading it went with, so a reviewer can disagree at a glance.

You can shape it further by describing your project and languages, or by editing the translation prompt directly. Read more.

Translation memory

Tolgee automatically suggests translations based on those you've previously used in the project, ensuring consistency across similar phrases.

Translation memory suggestions include the similarity percentage, the key, and the original text of the translated string, making it easy to maintain accuracy and coherence.

Auto translation

When enabled, Tolgee instantly translates new keys using translation memory or machine translation services, ensuring your strings are translated immediately upon creation. Simply choose whether to use translation memory and select your preferred machine translation service for seamless automation.

Activity log

Easily track who modified, reviewed, or commented on phrases in your project—all with complete clarity.

Comment on translations

If something seems off, let others know what you'd change. You can leave comments on any translation directly within the Tolgee platform.

Translation history

Easily track changes to specific translations of a particular key in a specific language. If something's amiss, you'll know exactly where to point the finger!

MCP Server

Tolgee exposes an MCP (Model Context Protocol) server that lets AI coding assistants manage translations directly — search keys, create and update translations, manage languages, trigger machine translation, and more — all without leaving your editor. See DEVELOPMENT.md for setup instructions.

Documentation

The docs cover all aspects of using Tolgee. Some highlights include:

Getting Started 🚀

  1. Sign up at app.tolgee.io or access your self-hosted instance
  2. Create a project
  3. Follow a guide in the integration section of your project
  4. Have fun!

[Integration guides]

Report a Bug

For filing bugs, suggesting improvements, or requesting new features, please open an issue.

How to contribute

You wanna contribute? Great to hear that! You can start right away!

Contributors

[contributors]

Let us know what you think! #FeedbackWanted ❤️

来源：README.md，提交 1c6139c

工具

22

get_batch_job_status

Get the status of a batch job (e.g. machine translation) by its ID. Use to poll for completion.

输入参数jobId必填projectId

machine_translate

Start machine translation for specified keys into target languages. Returns a batch job ID — use get_batch_job_status to poll for completion.

输入参数branchkeyNames必填namespaceprojectIdtargetLanguageTags必填

store_big_meta

Store key relationships so Tolgee can use translations of related keys as context during machine translation, producing more consistent results. Keys that appear near each other in source code (e.g. on the same page or component) should be stored as related.

输入参数branchprojectIdrelatedKeysInOrder必填

list_branches

List branches in a Tolgee project. Returns up to 100 results per page. Only available for projects with branching enabled (enterprise feature).

输入参数pagesearchprojectId

create_branch

Create a new branch in a Tolgee project by forking from an existing branch. Only available for projects with branching enabled (enterprise feature).

输入参数name必填projectIdoriginBranchId必填

delete_branch

Delete a branch from a Tolgee project. IMPORTANT: This is a destructive operation. The AI assistant should always confirm with the user before calling this tool.

输入参数projectIdbranchName必填

list_keys

List translation keys in a Tolgee project. Returns up to 100 keys per page. Use search_keys to find specific keys by name or translation text.

输入参数pagebranchprojectId

search_keys

Search for translation keys in a Tolgee project by name or translation text. Returns up to 50 matching keys per page. Note: namespace and tags filtering is not yet supported — filter results client-side if needed.

输入参数pagequery必填branchprojectIdlanguageTag

create_keys

Create translation keys in a Tolgee project with optional translations and tags. Keys that already exist are silently skipped — their translations and tags are not updated. Use update_key and set_translation to modify existing keys.

输入参数keys必填branchnamespaceprojectId

get_key

Get a translation key's metadata (name, namespace, description) by its name. To get the key's translations, use get_translations.

输入参数branchkeyName必填namespaceprojectId

update_key

Update an existing translation key's name, namespace, or description

输入参数keyName必填newName必填keyBranchprojectIdkeyNamespacenewNamespacenewDescription

delete_keys

Delete translation keys from a Tolgee project. IMPORTANT: This is a destructive operation. The AI assistant should always confirm with the user before calling this tool.

输入参数branchkeyNames必填namespaceprojectId

list_languages

List all languages configured for a Tolgee project. Returns up to 1000 results per page.

输入参数pageprojectId

create_language

Add a new language to a Tolgee project

输入参数tag必填name必填flagEmojiprojectIdoriginalName

list_namespaces

List all namespaces in a Tolgee project. Namespaces organize translation keys into logical groups (e.g. by feature, page, or module).

输入参数projectId

list_projects

List Tolgee projects accessible to the current user. Returns up to 100 results per page.

输入参数pagesearch

create_project

Create a new Tolgee project with initial languages

输入参数name必填languages必填organizationId必填baseLanguageTag

get_project_language_statistics

Get translation status and progress for each language in a project. Returns per-language statistics including translated, reviewed, and untranslated percentages.

输入参数projectId

list_tags

List all tags used in a Tolgee project. Returns up to 1000 results per page.

输入参数pagesearchprojectId

tag_keys

Add tags to translation keys. Creates tags if they don't exist.

输入参数tags必填branchkeyNames必填namespaceprojectId

get_translations

Get translations for a specific key in a Tolgee project. Returns translations in all project languages, or only the specified languages if provided.

输入参数branchkeyName必填languagesnamespaceprojectId

set_translation

Set or update translations for a key in one or more languages. The key must already exist — use create_keys to create it first.

输入参数branchkeyName必填namespaceprojectIdtranslations必填

版本历史

1
  1. v1.0.0最新Sep 16, 2026

评分

已满足适用检查项的 90%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。