Cursor AI with MCP

Model Context Protocol (MCP) is a standard designed to provide Large Language Model (LLM) agents with a way to communicate with the outside world through standardized APIs. In this article, you’ll learn how to configure MCP for Cursor AI, a VS Code-based code editor, that enhances your coding experience with the help of AI.

About the integration

mcp-simplelocalize integration provides a locally managed MCP server for SimpleLocalize and uses the official SimpleLocalize API to manage translation keys and translations in your projects. It allows you to, ask Cursor AI to add translation keys from your code to SimpleLocalize.

Please note the integration is community-made and not officially maintained by SimpleLocalize. If you have any questions or issues, please reach out to the community or contact SimpleLocalize support.

Installation

1. Install UV

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

2. Clone repository with the integration

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

3. Install dependencies

uv sync

4. Configure Cursor AI

Go to Cursor AI settings and add a new global MCP server.

Make sure you correctly set up the path to the mcp-simplelocalize folder in the mcpServers section of your MCP configuration file. Remember also to set the SIMPLELOCALIZE_API_KEY with your SimpleLocalize project API key.

{
  "mcpServers": {
    "simplelocalize": {
      "command": "uv",
      "args": [
       "run",
       "--project",
       "/path/to/mcp-simplelocalize/",
       "/path/to/mcp-simplelocalize/main.py"
      ],
      "env": {
       "SIMPLELOCALIZE_API_KEY": "your-project-api-key-here"
      }
    }
  }
}

Important: Add .cursor/mcp.json to .gitignore file to avoid exposing your API key.

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`, `de`, `es`, and `pl`.
- (any other conventions you want the LLM to follow, e.g. key naming style, etc. or just give it some examples would work well)

Usage

You can now ask Cursor AI to add translation keys from your code to SimpleLocalize using prompts like:

Localize this component and update it to SimpleLocalize

or

Add all translation keys together with translations to SimpleLocalize

Extension support

SimpleLocalize Extension for VS Code is also compatible with the newest version of Cursor AI.