String Catalog MCP

🚀 string-catalog-mcp

Xcode String Catalog (.xcstrings)ファイルを扱うためのMCPサーバーです。AIアシスタントがiOS/macOSのローカライズ文字列の読み取り、検索、更新を行うことができます。

🚀 クイックスタート

このセクションでは、string-catalog-mcpのインストールと基本的な使用方法を説明します。

📦 インストール

以下のコマンドを使用して、string-catalog-mcpをインストールします。

pnpm install
pnpm build

💻 使用例

基本的な使用法

Claude Codeで使用する場合、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

文字列カタログ内の翻訳を追加または更新します。iOS形式のプレースホルダー（%@, %d, %lld, %f, %1$@）をサポートする構造化されたJSONペイロードを受け付けます。

"「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ライセンスの下で公開されています。