Simplelocalize

🚀 mcp-simplelocalize

An MCP (Model Context Protocol) server implementation for SimpleLocalize.

🚀 Quick Start

📦 Installation

1. Install uv

curl -LsSf https://astral.sh/uv/install.sh | sh

2. Clone the repository

git clone https://github.com/GalvinGao/mcp-simplelocalize.git

3. Install dependencies

uv sync

4. Configure Cursor You may want to place this file at .cursor/mcp.json in the root directory of your project, as the SimpleLocalize API key is specific to a single project. Don't forget to add it to your .gitignore file to avoid exposing the 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"
            }
        }
    }
}

5. Describe your project's localization requirements under .cursorrules. For example:

## Translations
- Place all translations under the `default` namespace.
- The language codes supported by this project are `en-US`, `ja-JP`, `ko-KR`, and `zh-Hant`.
- (Any other conventions you want the LLM to follow, such as key naming styles, or just give it some examples.)

6. Done! Enjoy prompts like "Localize this component and update it to SimpleLocalize".

📄 License

This project is licensed under the MIT License. For more details, see the LICENSE file.

💪 Contribution

Contributions are welcome! Feel free to open an issue or submit a pull request.