CopyTuner Client

Rails i18nの翻訳管理サービス「CopyTuner」のMCP（Model Context Protocol）サーバー実装です。AIアシスタントがRailsアプリケーションの多言語化対応を効率的に支援するためのツールセットを提供します。

このgemは、CopyTunerプロジェクトの翻訳データにアクセスし、Rails i18nキーの検索、翻訳の管理、新しいキーの作成などをMCPプロトコル経由で実行できるサーバーを提供します。

- search_key: Rails i18nキーの検索（t()やI18n.t()で使用されるキーの検索に最適化）。翻訳済みのキーに加え、登録済みだが訳が空のキーも返す（空文字列""で表現）。空文字列で返ってきたキーはすでに登録済みなので、create_i18n_keyではなくupdate_i18n_keyで翻訳を設定する
- search_translations: 翻訳内容による検索（特定のテキストを含む翻訳の検索）。翻訳済みキーのみが対象で、訳が空のキーは含まない
- create_i18n_key: 新しいi18nキーの作成（複数言語対応）。CopyTuner API v3経由でdraftを同期登録するため、既存キーの重複やロケール数上限超過などのバリデーションエラーは即座に返る。新規登録専用で既存キーは拒否する（既存キーの更新はupdate_i18n_keyを使う）。デフォルトではキャッシュへの反映を最大2分待ってから返る（wait: falseを指定すると即時返却）。公開は別途CopyTuner側で行われる
- update_i18n_key: 既存i18nキーのdraft翻訳の更新（複数言語対応）。未公開（または公開済みでも空）の訳のみ更新可能で、公開済みの訳を更新しようとするとエラーになる。デフォルトではキャッシュへの反映を最大2分待ってから返る（wait: falseを指定すると即時返却）
- get_locales: プロジェクトで使用中のロケール一覧の取得
- get_edit_url: 登録済みキーの編集画面URLの生成

- copytuner://projects/{project_id}/translations/{locale}/{key}: 個別の翻訳リソースへのアクセス

group :development do gem 'copy_tuner_client-mcp', github: 'SonicGarden/copy_tuner_client-mcp', require: false end

まず、Railsアプリケーションでcopy_tuner_clientが適切に設定されている必要があります：

# config/initializers/copy_tuner_client.rb CopyTunerClient.configure do |config| config.api_key = "your-api-key" config.project_id = "your-project-id" config.locales = ["ja", "en"] end

MCPプロトコルに対応したAIアシスタント（Claude Code、VSCode Copilot等）で、以下の設定ファイルを配置するとMCPサーバーが自動的に起動され、翻訳管理機能が利用可能になります。

{ "mcpServers": { "copy-tuner": { "command": "bundle", "args": ["exec", "copy-tuner-mcp"] } } }

{ "servers": { "copy-tuner": { "type": "stdio", "command": "bundle", "args": ["exec", "copy-tuner-mcp"], "cwd": "${workspaceFolder}" } } }

プロジェクトのルートディレクトリにCLAUDE.ymlファイルを作成することで、AIアシスタントがプロジェクトの国際化の仕組みを理解できるようになります：

# CLAUDE.md ## 国際化（i18n）について - i18nのバックエンドにはcopy_tunerというサーバでi18nデータを管理する仕組みを利用 - i18nのキーや内容を参照する場合は、copy_tunerから取得する必要がある - config/locales 配下のファイルは利用していません - copy_tunerサーバと連携してローカライズデータを管理

user.profile.bioというキーで「プロフィール」（日本語）と「Profile」（英語）の翻訳を作成してください

通常はAIアシスタントの設定ファイルを通じて自動的に起動されますが、動作確認やデバッグが必要な場合は、Railsアプリケーションのルートディレクトリで以下を実行して手動起動できます：

This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.

Suppr - AI-powered document translation and academic search service. Supports high-quality translation of PDF, DOCX, PPTX and other formats in 11 languages with optimized mathematical formula handling. Includes PubMed-integrated intelligent literature search for researchers. https://suppr.wilddata.cn/

Semantic code search for AI agents without indexing your codebase or storing any data. Fast and accurate.

Create and read feature flags, review experiments, generate flag types, search docs, and interact with GrowthBook's feature flagging and experimentation platform.

Make your AI agent speak every language on the planet, using Lingo.dev Localization Engine.

Word search, crossword, and sudoku generator MCP server with printable PDF worksheets, themed word banks, and verifiable LLM evals. Local-first, from the makers of puzzletide.com.

Official MCP server for Stimulsoft Reports & Dashboards documentation. Semantic search across FAQ, Programming Manual, Server/User Manual, and Server/Cloud API for .NET, WPF, Avalonia, WEB, Blazor, Angular, React, JS, PHP, Java, and Python platforms.

Searching and access your AI coding sessions from Claude Code, Gemini CLI, opencode, and OpenAI Codex.

Search Apple's Developer Documentation with smart search and wildcard support.

MCP server that exposes ast-grep (sg) as two tools for structural code search.

Search everything your terminal ever printed. Local MCP server over per-command recorded output: full-text search, exit codes, diffs, secret redaction. Built and maintained by an AI agent (Soren Achebe).