SimpleLocalize MCP Server
A Model Context Protocol server that enables users to manage translations for their applications through SimpleLocalize's localization platform via natural language prompts in Cursor.
README Documentation
mcp-simplelocalize
A MCP (Model Context Protocol) server implementation for SimpleLocalize.
Usage
Install
curl -LsSf https://astral.sh/uv/install.sh | sh
- Clone the repository
git clone https://github.com/GalvinGao/mcp-simplelocalize.git
- Install dependencies
uv sync
- Configure Cursor
You may wish to put this at .cursor/mcp.json under your project root, since SimpleLocalize API Key is specific to a single project.
Don't forget to add it to your .gitignore file to avoid exposing your API key.
{
"mcpServers": {
"simplelocalize": {
"command": "uv",
"args": [
"run",
"--project",
"/path/to/mcp-simplelocalize/",
"/path/to/mcp-simplelocalize/main.py"
],
"env": {
"SIMPLELOCALIZE_API_KEY": "your-api-key-here"
}
}
}
}
- Describe your project localization requirements under
.cursorrules. For example:
## Translations
- Put all translations under the `default` namespace
- Language codes supported by this project: `en-US`, `ja-JP`, `ko-KR`, and `zh-Hant`.
- (any other conventions you want the LLM to follow, e.g. key naming style, etc. or just give it some examples would work well)
- Done! Enjoy prompting something like "Localize this component and update it to SimpleLocalize".
License
This project is licensed under the MIT License. See the LICENSE file for details.
Contributing
Stop creating automated PRs that promotes your service on this README. You will be blocked and your PR will NOT get merged. Well I just realized automated scripts won't see this anyways... PRs related to the actual codes are still appreciated!
Contributions are welcome! Feel free to open an issue or submit a pull request.