Jacobolevy/smartling-mcp-server
If you are the rightful owner of smartling-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
The Smartling MCP Server is a comprehensive Model Context Protocol server that integrates with Smartling's main APIs for advanced translation management.
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
- Go to Smartling Dashboard → Settings → API
- Create User Identifier and User Secret
- Copy to your config files
- 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:
- - Node.js backend integration
- - WebSocket integration
- - 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
- - Development guide
- - 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 file for details.