JSPM

  • Created
  • Published
  • Downloads 374
  • Score
    100M100P100Q122647F
  • License MIT

MCP client for i18n-agent translation service - supports Claude, Cursor, VS Code, and other AI IDEs

Package Exports

  • @i18n-agent/mcp-client
  • @i18n-agent/mcp-client/mcp-client.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@i18n-agent/mcp-client) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

šŸŒ i18n-agent MCP Client

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

npm version License: 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
  • 🌐 30+ Languages: Multi-tier language support with quality ratings
  • šŸ”§ Easy Setup: One-command installation for major AI IDEs

šŸš€ Quick Installation

Install via npx (recommended):

npx @i18n-agent/mcp-client install

Or install globally:

npm install -g @i18n-agent/mcp-client
i18n-agent-install

šŸ”‘ Setup API Key

  1. Get your API key from app.i18nagent.ai

  2. Set environment variable:

    export API_KEY=your-api-key-here
  3. Make it permanent (add to ~/.bashrc or ~/.zshrc):

    echo 'export 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

šŸ›  Supported AI IDEs

IDE Status Config Location
Claude Desktop āœ… Auto-configured ~/Library/Application Support/Claude/claude_desktop_config.json
Cursor āœ… Auto-configured ~/.cursor/mcp_settings.json
VS Code āœ… Auto-configured ~/.vscode/mcp_settings.json
Other MCP IDEs šŸ”§ Manual setup Varies

🌐 Language Support

Tier 1 - Excellent Quality

  • en: English
  • fr: French
  • de: German
  • es: Spanish
  • it: Italian
  • pt: Portuguese
  • ru: Russian
  • ja: Japanese
  • ko: Korean
  • zh-CN: Chinese (Simplified)

Tier 2 - High Quality

  • nl: Dutch
  • pl: Polish
  • cs: Czech
  • ar: Arabic
  • he: Hebrew
  • hi: Hindi
  • zh-TW: Chinese (Traditional)
  • sv: Swedish
  • da: Danish
  • no: Norwegian
  • fi: Finnish

Tier 3 - Good Quality

  • tr: Turkish
  • hu: Hungarian
  • th: Thai
  • vi: Vietnamese
  • uk: Ukrainian
  • bg: Bulgarian
  • ro: Romanian
  • hr: Croatian
  • sk: Slovak
  • sl: Slovenian
  • et: Estonian
  • lv: Latvian
  • lt: Lithuanian

šŸ“ Supported File Formats

Format Extension Features
JSON .json Preserves structure, nested objects
YAML .yaml, .yml Maintains formatting, comments
CSV .csv Handles quoted fields, commas
XML/HTML .xml, .html Extracts text content
Markdown .md Preserves formatting, skips code
Properties .properties Key-value pairs
Plain Text .txt Direct translation

šŸ”§ Manual Setup

If auto-installation fails, you can manually configure your IDE:

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "i18n-agent": {
      "command": "node",
      "args": ["/path/to/mcp-client.js"],
      "env": {
        "MCP_SERVER_URL": "https://mcp.i18nagent.ai",
        "API_KEY": "your-api-key-here"
      }
    }
  }
}

Cursor / VS Code

Create .cursor/mcp_settings.json or .vscode/mcp_settings.json:

{
  "mcpServers": {
    "i18n-agent": {
      "command": "node", 
      "args": ["/path/to/mcp-client.js"],
      "env": {
        "MCP_SERVER_URL": "https://mcp.i18nagent.ai",
        "API_KEY": "your-api-key-here"
      }
    }
  }
}

šŸ’” Usage Tips

Translation Context

  • Target Audience: Specify "technical", "casual", "formal", or "general"
  • Industry Context: Use "technology", "healthcare", "finance", "education"
  • Regional Variations: Add regions like "Spain", "Mexico", "Brazil"

File Translation

  • Preserve Structure: Keeps original file format and structure
  • Output Format: Convert between formats (JSON ↔ YAML ↔ CSV)
  • Large Files: Automatically chunks large files for processing
  • Async Processing: Files >50KB processed asynchronously with job tracking
  • Progress Monitoring: Real-time status updates for long-running translations
  • Timeout Resilience: Up to 10 minutes for large translation jobs

Large Translation Handling

  • Async Processing: >100 texts or >50KB files processed asynchronously
  • Job Tracking: Unique job IDs for monitoring long-running translations
  • Progress Updates: Real-time completion percentages and status
  • Extended Timeouts: 5-10 minute timeouts prevent interruptions
  • Automatic Polling: Client automatically polls for job completion

Credit Management

  • Cost: 0.001 credits per word
  • Monitoring: Check balance before large translations
  • Estimates: Get word count estimates before translation

🚨 Troubleshooting

Installation Issues

Permission denied:

sudo npm install -g @i18n-agent/mcp-client

IDE not detected:

# Check if IDE directory exists
ls ~/Library/Application\ Support/Claude/
ls ~/.cursor/
ls ~/.vscode/

Runtime Issues

API Key not found:

echo $API_KEY  # Should show your key
export API_KEY=your-key-here

Connection errors:

  • Check your internet connection
  • Verify API key is valid
  • Try again after a few seconds

Translation quality:

  • Use Tier 1 languages for production
  • Add context with industry/audience parameters
  • Review Tier 2/3 translations manually

šŸ“Š Pricing

  • Pay-per-use: 0.001 credits per word
  • No subscriptions: Only pay for what you translate
  • Bulk discounts: Available for enterprise usage
  • Free tier: New accounts get starter credits

šŸ” Privacy & Security

  • No data storage: Translations are processed in real-time
  • Encrypted transport: All data sent over HTTPS
  • API key security: Keys are stored locally, never transmitted in logs
  • GDPR compliant: EU privacy standards

šŸ¤ Contributing

We welcome contributions! Please see our Contributing Guidelines.

Development Setup

git clone https://github.com/i18n-agent/mcp-client.git
cd mcp-client
npm install
npm test

šŸ“ License

MIT License - see LICENSE file for details.

Copyright (c) 2025 FatCouple OÜ

šŸ†˜ Support


Made with ā¤ļø by FatCouple OÜ