Smartling MCP Server

A Model Context Protocol (MCP) server that provides Smartling translation tools for Claude Desktop, Cursor, and other MCP-compatible applications.

🚀 Quick Installation

Prerequisites

• Node.js 18.0.0 or higher
• Smartling API credentials (User Identifier and User Secret)

Installation Steps

# Clone the repository
git clone https://github.com/YOUR_USERNAME/smartling-mcp-server.git
cd smartling-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

# Setup environment variables
cp config-example.env .env
# Edit .env with your Smartling credentials

⚙️ Add Your Credentials

Edit the generated config files with your Smartling credentials:

Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json
Cursor: ~/.cursor/mcp.json

Replace:

"SMARTLING_USER_IDENTIFIER": "your_user_id_here",
"SMARTLING_USER_SECRET": "your_user_secret_here"

🔑 Get Smartling Credentials

1. Go to Smartling Dashboard → Settings → API
2. Create User Identifier and User Secret
3. Copy to your config files
4. Restart Claude Desktop/Cursor

✅ Verification

Ask Claude Desktop or Cursor:

"How many Smartling tools do you have available?"

🛠️ Available Tools

Core Features

• Project Management: Access and manage translation projects
• File Operations: Upload, download, and manage translation files
• Job Management: Create and manage translation jobs
• String Operations: Search, filter, and manage translation strings
• Quality Assurance: Run quality checks on translations
• Locales: Manage project locales and supported languages
• Glossaries: Manage translation glossaries and terms
• Context: Upload and manage visual context for translators
• Webhooks: Set up notifications for translation events
• Reports: Generate progress and analytics reports

Chat Integration

For internal chat platforms, see:

• Internal Platform Client - Node.js backend integration
• Streaming Client Example - WebSocket integration
• Usage Examples - Additional integration examples

📋 Configuration Example

Claude Desktop config:

{
  "mcpServers": {
    "smartling": {
      "command": "node",
      "args": ["/path/to/smartling-mcp-server/dist/index.js"],
      "env": {
        "SMARTLING_USER_IDENTIFIER": "your_user_identifier",
        "SMARTLING_USER_SECRET": "your_user_secret",
        "SMARTLING_BASE_URL": "https://api.smartling.com"
      }
    }
  }
}

🧪 Testing

Test your installation:

# Run basic tests
npm test

# Test MCP protocol
npm run test:mcp

🐛 Troubleshooting

Issue	Solution
"0 tools enabled"	Check configuration file paths
"Connection timeout"	Verify API credentials and network access
"Could not attach to MCP server"	Ensure Node.js 18+ is installed

📚 Documentation

• CONTRIBUTING.md - Development guide
• Usage Examples - Integration examples
• API Documentation - Smartling API reference

🌟 Key Features

For Organizations

• Enterprise Ready: Production-tested translation workflows
• Secure: API credential management
• Reliable: Comprehensive error handling
• Easy Integration: Works with existing MCP tools

For Developers

• Direct API Access: Full Smartling API integration
• Chat Integration: Ready for internal platforms
• Extensible: Add more tools easily
• Well Documented: Complete guides and examples

📞 Support

• Issues: GitHub Issues
• API Documentation: Smartling Developers

📄 License

MIT License - see LICENSE file for details.