Lokalise MCP Tool

A Minimal Command-line Program (MCP) server for adding translation keys to your Lokalise projects, designed for integration withCursoror standalone use.

# For MCP usage (global installation) npm install -g lokalise-mcp-server # For library usage (project dependency) npm install lokalise-mcp-server

NPM Package:https://www.npmjs.com/package/lokalise-mcp-server

{ "mcpServers": { "lokalise": { "command": "npx", "args": ["-y", "lokalise-mcp-server"], "env": { "LOKALISE_API_KEY": "your_actual_api_key" } } } }

- 🔄Reload Window.It will automatically use the npm package.

No need to run Docker or Podman manually!
-

🐳 Make sure Docker or Podman is installed and running.

🛠️ Add this to yourmcp.json(or configure via Cursor UI):

{ "mcpServers": { "lokalise": { "command": "docker", // podman "args": [ "run", "--rm", "-i", "-e", "LOKALISE_API_KEY", "rafee03/mcp-lokalise:latest" ], "env": { "LOKALISE_API_KEY": "your_actual_api_key" } } } }

- You can usepodmaninstead ofdockerif you prefer.
- Cursor will automatically pull and run the image as needed.

🔄Restart Cursor.It will handle everything for you.

- projectName(required): The name of your Lokalise project (e.g.,SpaceX).
- keys(required): An array of objects, each with:

- keyName(required): The translation key (e.g.,hello)
- defaultValue(optional): The default translation value (e.g.,Hello)
- platforms(optional): The platforms this key applies to (e.g.,web,ios)

I want to add two keys, one is hello and another one is bye. their default values are Hello and Goodbye. both are in web platform. the project is spaceX

Cursor will automatically convert this to the correct input for the MCP tool.

- src/mcp-server.ts: The main MCP server entry point for Cursor integration.
- src/mcp.ts: Shared logic for interacting with the Lokalise API (used by the server).
- src/server.ts: (Optional) HTTP server version (not required for Cursor).
- src/add-key.ts: (Optional) CLI tool for adding a key interactively (not required for Cursor).

- dist/mcp-server.js: Compiled MCP server.
- dist/mcp.js: Compiled API logic.
- dist/server.js: Compiled HTTP server.
- dist/add-key.js: Compiled CLI tool.

- tsconfig.json: TypeScript configuration.
- Dockerfile: For building the Docker image of the MCP server.
- package.json: Project dependencies and scripts.
- README.md: This documentation file.

🛠️ Setup (For Local Development or Customization)

git clone https://github.com/mdrafee03/mcp-lokalise.git cd mcp-lokalise

In your MCP config (recommended for Cursor)

{ "mcpServers": { "lokalise": { "command": "node", "args": ["{directory-of-the-project}/dist/mcp-server.js"], "env": { "LOKALISE_API_KEY": "your_actual_api_key" } } } }

- npm run build- Compile TypeScript to JavaScript
- npm run dev- Run the MCP server in development mode with tsx
- npm run server- Run the HTTP server in development mode with tsx
- npm run add-key- Run the CLI tool in development mode with tsx
- npm start- Run the compiled MCP server from dist/

- Node.js 22+ recommended
- TypeScript 5.8+
- MCP protocol via@modelcontextprotocol/sdk

Executes Manim Python animation scripts to generate and return videos.