String Catalog MCP

🚀 string-catalog-mcp

string-catalog-mcp 是一個用於處理 Xcode 字符串目錄（.xcstrings）文件的 MCP 服務器。它允許 AI 助手讀取、搜索和更新你的 iOS/macOS 本地化字符串。

🚀 快速開始

📦 安裝指南

pnpm install
pnpm build

💻 使用示例

基礎用法

在你的 MCP 配置中添加以下內容：

{
  "mcpServers": {
    "string-catalog-mcp": {
      "command": "pnpm",
      "args": ["dlx", "string-catalog-mcp"]
    }
  }
}

📚 詳細文檔

🔧 可用工具

list_supported_languages

列出字符串目錄中所有語言，並標識出源語言。

"我的 Localizable.xcstrings 文件支持哪些語言？"

get_catalog_statistics

獲取每種語言的翻譯覆蓋情況，包括總鍵數和完成百分比。

"給我展示我的字符串目錄的翻譯統計信息"

get_translations_for_key

獲取特定鍵在所有支持語言中的所有翻譯。

"給我展示 'welcome_message' 鍵的所有翻譯"

search_keys

搜索包含特定子字符串的本地化鍵（不區分大小寫）。

"在我的字符串目錄中查找所有包含 'error' 的鍵"

list_all_keys

列出目錄中的所有本地化鍵（支持大目錄的分頁）。

"列出我項目中的所有本地化鍵"

update_translations

在字符串目錄中添加或更新翻譯。接受結構化的 JSON 負載，支持 iOS 格式佔位符（%@, %d, %lld, %f, %1$@）。

"為 'hello_world' 鍵添加德語和法語翻譯"

🔧 可用提示

translate-strings

為特定鍵生成翻譯，並提供格式佔位符的指導。

"使用 translate-strings 提示將 'welcome_message' 和 'goodbye' 翻譯成德語、法語和日語"

batch-translate

為指定語言翻譯目錄中所有未翻譯或過時的字符串。

"使用 batch-translate 為我的目錄中所有缺失的字符串添加德語翻譯"

review-translations

審查現有翻譯的質量、一致性和佔位符使用情況。

"審查我的德語翻譯是否存在質量問題"

🔧 常見工作流程

為你的應用添加新語言

1. "我的 Localizable.xcstrings 文件支持哪些語言？"
2. "使用 batch-translate 為 /path/to/Localizable.xcstrings 添加西班牙語翻譯"

翻譯特定字符串

1. "在我的字符串目錄中搜索包含 'settings' 的鍵"
2. "給我展示 'settings_title' 鍵的翻譯"
3. "將 'settings_title' 和 'settings_description' 翻譯成德語和法語"

審查翻譯質量

1. "給我展示我的目錄的翻譯統計信息"
2. "審查德語翻譯的佔位符問題和一致性"

📄 許可證

本項目採用 MIT 許可證。