mcp-simplelocalize

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

Usage

Install

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 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"
   }
  }
 }
}

5. 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)

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

Related MCP server: Shortcut MCP Server

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.