Xcstrings Crud

🚀 xcstrings-crud

xcstrings（String Catalog）ファイルのCRUD操作を行うためのCLIツールとMCPサーバーです。このツールは、大規模なxcstringsファイルの管理を効率的に行うことができます。

🚀 クイックスタート

このツールは、大規模なxcstringsファイルを扱う際に、AIアシスタントが消費するトークンを最小限に抑えることができます。特定のキーや言語のみを取得したり、個別の翻訳を追加・更新したりすることができます。

✨ 主な機能

• トークン効率的なアプローチ：必要な情報のみを取得し、トークンの消費を抑えます。
• ターゲット指向のCRUD操作：特定のキーや言語に対して操作を行うことができます。
• インクリメンタルな更新：ファイル全体を読み込まずに、個別の翻訳を追加または更新できます。
• クイックな統計情報：全てのエントリを解析せずに、カバレッジや進捗状況の概要を取得できます。

📦 インストール

Miseを使用する場合

mise use -g ubi:Ryu0118/xcstrings-crud

nestを使用する場合 (mtj0928/nest)

nest install Ryu0118/xcstrings-crud

ソースからビルドする場合

git clone https://github.com/Ryu0118/xcstrings-crud.git
cd xcstrings-crud
swift build -c release

バイナリは .build/release/xcstrings-crud に配置されます。

🔧 MCPサーバー

MCPサーバーはサブコマンドとして利用できます。

xcstrings-crud mcp

設定

Claude CodeのMCP設定に追加します。

{
  "mcpServers": {
    "xcstrings-crud": {
      "command": "xcstrings-crud",
      "args": ["mcp"]
    }
  }
}

利用可能なツール

💻 使用例

基本的な使用法

作成操作

# 新しいxcstringsファイルを作成する
xcstrings-crud create path/to/Localizable.xcstrings

# 特定のソース言語で作成する
xcstrings-crud create path/to/Localizable.xcstrings --source-language ja

# 既存のファイルを上書きする
xcstrings-crud create path/to/Localizable.xcstrings --overwrite

読み取り操作

# すべてのキーをリストする
xcstrings-crud list keys --file path/to/Localizable.xcstrings

# 言語をリストする
xcstrings-crud list languages --file path/to/Localizable.xcstrings

# 特定の言語の未翻訳キーをリストする
xcstrings-crud list untranslated --file path/to/Localizable.xcstrings --lang ja

# 古いキー（潜在的に未使用）をリストする
xcstrings-crud list stale --file path/to/Localizable.xcstrings

# 複数のファイルにまたがる古いキーをリストする
xcstrings-crud batch stale -f file1.xcstrings file2.xcstrings file3.xcstrings

# ソース言語を取得する
xcstrings-crud get source-language --file path/to/Localizable.xcstrings

# キーの翻訳を取得する
xcstrings-crud get key "Hello" --file path/to/Localizable.xcstrings
xcstrings-crud get key "Hello" --file path/to/Localizable.xcstrings --lang ja

# キーが存在するかチェックする
xcstrings-crud check key "Hello" --file path/to/Localizable.xcstrings

# キーのカバレッジをチェックする
xcstrings-crud check coverage "Hello" --file path/to/Localizable.xcstrings

# 全体の統計情報を取得する
xcstrings-crud stats coverage --file path/to/Localizable.xcstrings

# 特定の言語の進捗を取得する
xcstrings-crud stats progress --file path/to/Localizable.xcstrings --lang ja

# 複数のファイルのバッチカバレッジを取得する
xcstrings-crud stats batch-coverage -f file1.xcstrings file2.xcstrings file3.xcstrings

更新操作

# 単一の言語の翻訳を追加する
xcstrings-crud add key "Hello" --file path/to/Localizable.xcstrings --lang ja --value "こんにちは"

# 複数の言語の翻訳を追加する
xcstrings-crud add key "Hello" --file path/to/Localizable.xcstrings -t ja:こんにちは en:Hello

# 単一の言語の翻訳を更新する
xcstrings-crud update key "Hello" --file path/to/Localizable.xcstrings --lang ja --value "こんにちは！"

# 複数の言語の翻訳を更新する
xcstrings-crud update key "Hello" --file path/to/Localizable.xcstrings -t ja:こんにちは en:Hello de:Hallo

# キーをリネームする
xcstrings-crud rename key "Hello" --file path/to/Localizable.xcstrings --to "Greeting"

削除操作

# キー全体を削除する
xcstrings-crud delete key "Hello" --file path/to/Localizable.xcstrings

# 特定の言語の翻訳のみを削除する
xcstrings-crud delete key "Hello" --file path/to/Localizable.xcstrings -l ja

# 複数の言語の翻訳を削除する
xcstrings-crud delete key "Hello" --file path/to/Localizable.xcstrings -l ja en fr

バッチ操作

# 複数のファイルにまたがる古いキーをリストする
xcstrings-crud batch stale -f file1.xcstrings file2.xcstrings file3.xcstrings

# 複数のキーが存在するかチェックする
xcstrings-crud batch check --file path/to/Localizable.xcstrings -k Hello Goodbye Welcome

# 特定の言語でチェックする
xcstrings-crud batch check --file path/to/Localizable.xcstrings -k Hello Goodbye -l ja

# 複数のキーの翻訳を一度に追加する
xcstrings-crud batch add --file path/to/Localizable.xcstrings \
  -e "Hello=ja:こんにちは,en:Hello" \
  -e "Goodbye=ja:さようなら,en:Goodbye"

# 上書きして追加する（既存の翻訳を置き換える）
xcstrings-crud batch add --file path/to/Localizable.xcstrings --overwrite \
  -e "Hello=ja:こんにちは,en:Hello"

# 複数のキーの翻訳を一度に更新する
xcstrings-crud batch update --file path/to/Localizable.xcstrings \
  -e "Hello=ja:こんにちは！,en:Hello!" \
  -e "Goodbye=ja:さようなら！"

共通オプション

• --file <path>: xcstringsファイルのパス（必須）
• --pretty: 整形されたJSON出力

📚 詳細ドキュメント

要件

• macOS 13以上
• Swift 6.0以上

📄 ライセンス

MIT