copy tuner client-MCP

CopyTunerClient:：Mcp

Rails i18n的翻译管理服务“CopyTuner”的MCP（Model Context Protocol）服务器实现。AI我的助手Rails它提供了一套工具来有效地帮助应用程序实现多语言化。

概要

这个gem单击功能区上CopyTuner访问项目翻译数据Rails i18n搜索关键字、管理翻译、创建新关键字MCP提供可通过协议运行的服务器。

机能

可用工具

• 搜索密钥: Rails i18n查找密钥（t()屋脊I18n.t()对较大场景进行渲染期间已观察到该故障。）
• 搜索_翻译：查找翻译内容（查找包含特定文本的翻译）
• create_i18n_key：新建i18n创建密钥（支持多种语言、异步处理）
• get_locales：获取项目中使用的区域设置列表
• get_edit_url：已登录键的编辑画面URL生成

资源模板

• copytuner://projects/{project_id}/translations/{locale}/{key}：访问单个翻译资源

安装

Gemfile添加：

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

然后执行：

bundle install

使用方法

1. CopyTunerClient配置

首先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

2. AI助手设置和使用

MCP协议AI用助手（Claude Code、VScode Copilot等）配置以下的设定文件的话MCP服务器将自动启动并提供翻译管理功能。

克劳德代码

在项目根目录中 .mcp.json 创建文件：

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

VSCode副驾驶

.vscode/mcp.json 创建文件：

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

CLAUDE.md设定例

在项目根目录中 CLAUDE.yml 通过创建文件AI帮助助手了解项目国际化的机制：

# CLAUDE.md

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

使用例

设定完成后AI助手可以：

查找关键字

user.nameに関連するi18nキーを検索してください

查找翻译内容

「ログイン」という文字を含む翻訳を検索してください

创建新密钥

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

3.手动启动（动作确认、调试用）

通常情况下AI通过助手配置文件自动启动，但如果需要确认动作或调试Rails可以在应用程序的根目录中执行以下操作来手动启动：

bundle exec copy-tuner-mcp

许可证

这个gem表示MIT许可证之后由应用程序进行调用。