i18n-agent

Install

Config snippet generator goes here (5 client tabs)

README

# 🌍 i18n-agent MCP Client

Professional translation service client for Claude, Cursor, VS Code, Antigravity, and other AI IDEs using the Model Context Protocol (MCP).

[![npm version](https://badge.fury.io/js/%40i18n-agent%2Fmcp-client.svg)](https://www.npmjs.com/package/@i18n-agent/mcp-client)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

## ✨ Features

- **🎯 Smart Translation**: Context-aware translations with cultural adaptation
- **📁 File Translation**: Support for JSON, YAML, CSV, XML, Markdown, and more
- **⚡ Large File Support**: Async processing for files >50KB with progress tracking
- **🔄 Timeout Improvements**: Extended timeouts (5-10 min) for large translations
- **📊 Progress Tracking**: Real-time job status and completion monitoring
- **💰 Credit Tracking**: Real-time credit balance and word count estimates
- **🌐 48 Languages**: Comprehensive language support with regional variants
- **🔧 Easy Setup**: One-command installation for major AI IDEs

## 🚀 Quick Installation

```bash
npx @i18n-agent/mcp-client install
```

The installer will detect all available AI IDEs and configure them automatically.

### Claude Code Marketplace Installation

For Claude Code users, you can install directly from the marketplace:

**Step 1: Get your API key**
- Visit [app.i18nagent.ai](https://app.i18nagent.ai)
- Sign up or log in
- Copy your API key (starts with "i18n_")

**Step 2: Set environment variable**
```bash
echo 'export I18N_AGENT_API_KEY=your-api-key-here' >> ~/.zshrc
source ~/.zshrc
```

Replace `your-api-key-here` with your actual API key.

**Step 3: Install from marketplace**
```bash
/plugin marketplace add i18n-agent/mcp-client
/plugin install i18n-agent@i18n-agent
```

**Step 4: Restart Claude Code**

That's it! The plugin will automatically use your API key from the environment variable.

## 🔑 Setup API Key

1. **Get your API key** from [app.i18nagent.ai](https://app.i18nagent.ai)

2. **Set environment variable**:
   ```bash
   export I18N_AGENT_API_KEY=your-api-key-here
   ```

3. **Make it permanent** (add to ~/.bashrc or ~/.zshrc):
   ```bash
   echo 'export I18N_AGENT_API_KEY=your-api-key-here' >> ~/.zshrc
   ```

4. **Restart your AI IDE** to load the new configuration

## 🎮 Usage Examples

### Text Translation
```
Translate "Hello, how are you?" to Spanish for a casual audience
```

### File Translation
```
Translate this JSON file to French, preserving the structure
```

### Credit Check
```
Check my translation credits
```

### Language Support
```
List supported languages with quality ratings
```

### Content Analysis
```
Analyze "Hello world! This is a test." for translation to Spanish
```

## 🛠 Supported AI IDEs

| IDE | Status | macOS | Windows | Linux |
|-----|--------|-------|---------|-------|
| **Claude Desktop** | ✅ Auto-configured | `~/Library/Application Support/Claude/` | `%APPDATA%\Claude\` | `~/.config/Claude/` |
| **Claude Code CLI** | ✅ Auto-configured | `~/.claude.json` | `~/.claude.json` | `~/.claude.json` |
| **Cursor** | ✅ Auto-configured | `~/.cursor/mcp_settings.json` | `~/.cursor/mcp_settings.json` | `~/.cursor/mcp_settings.json` |
| **VS Code** | ✅ Auto-configured | `~/.vscode/mcp_settings.json` | `~/.vscode/mcp_settings.json` | `~/.vscode/mcp_settings.json` |
| **Codex (OpenAI)** | ✅ Auto-configured | `~/.codex/mcp_settings.json` | `~/.codex/mcp_settings.json` | `~/.codex/mcp_settings.json` |
| **Antigravity (Google)** | ✅ Auto-configured | `~/.gemini/antigravity/mcp_config.json` | `%USERPROFILE%\.gemini\antigravity\mcp_config.json` | `~/.config/antigravity/mcp_config.json` |

**Note:** The installer automatically detects your platform and uses the correct config paths.

## 🌐 Language Support (48 Languages)
- **bg**: Bulgarian
- **ca**: Catalan
- **cs**: Czech
- **da**: Danish
- **de**: German
- **el**: Greek
- **en**: English
- **en-AU**: English (Australia)
- **en-CA**: English (Canada)
- **en-GB**: English (United Kingdom)
- **en-US**: English (United States)
- **es**: Spanish
- **es-MX**: Spanish (Mexico)
- **et**: Estonian
- **fi**: Finnish
- **fr**: French
- **fr-CA**: French (Canada)
- **hi**: Hindi
- **hr**: Croatian
- **hu**: Hungarian
- **id**: Indonesian
- **is**: Icelandic
- **it**: Italian
- **ja**: Japanese
- **ko**: Korean
- **lt**: Lithuanian
- **lv**: Latvian
- **ms**: Malay
- **nl**: Dutch
- **no**: Norwegian
- **pl**: Polish
- **pt**: Portuguese
- **pt-BR**: Portuguese (Brazil)
- **ro**: Romanian
- **ru**: Russian
- **sk**: Slovak
- **sl**: Slovenian
- **sr**: Serbian
- **sv**: Swedish
- **th**: Thai
- **tl**: Filipino
- **tr**: Turkish
- **uk**: Ukrainian
- **vi**: Vietnamese
- **zh-Hans**: Chinese (Simplified)
- **zh-Hant-HK**: Chinese (Traditional, Hong Kong)
- **zh-Hant-TW**: Chinese (Traditional, Taiwan)

## 📁 Supported File Formats

| Format | Extension | Features |
|--------|-----------|----------|
| JSON | `.json` | Preserves structure, nested objects |
| YAML | `.yam