mcpField
M
MCP Server for SimpleLocalize

MCP Server for SimpleLocalize

Local
github.com/simplelocalizeDeveloper Tools0Updated 6w ago
Repository

About MCP Server for SimpleLocalize

MCP server for developers and localization teams to manage SimpleLocalize projects through its API, including translations, keys, publishing, and project metadata.

Key features

  1. 01Manage translation keys and screenshots
  2. 02Read and update translations
  3. 03Run auto-translation jobs
  4. 04Manage tags, languages, and customers
  5. 05Import, export, and publish translations
  6. 06Access glossary and project activity

Use cases

  1. 01Edit localization data from an MCP client
  2. 02Run bulk translation updates
  3. 03Publish translations to hosting environments

MCP support

Exposes SimpleLocalize API operations as MCP tools for clients such as Claude Desktop, Cursor, Windsurf, and GitHub Copilot. Requires a SimpleLocalize project API key.

#i18n#typescript#mcp#llm#cursor-ai#mcp-server#modelcontextprotocol

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "simplelocalize": {
      "command": "npx",
      "args": [
        "-y",
        "@simplelocalize/simplelocalize-mcp"
      ]
    }
  }
}
Run commandnpx -y @simplelocalize/simplelocalize-mcp

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@simplelocalize/simplelocalize-mcp

Tools

14

Saved tool list · updated 3w ago

ParameterTypeRequiredDescription
translationKeysarrayYesArray of translation keys to create (max 100).

Details

From the project README

MCP Server for SimpleLocalize

SimpleLocalize is the developer-first translation management system.

This is a Model Context Protocol (MCP) server that provides tools for interacting with the SimpleLocalize API.

How to setup

Configure your mcp.json file and add 'simplelocalize':

{
  "mcpServers": {
    "simplelocalize": {
      "command": "npx",
      "args": [
        "-y",
        "@simplelocalize/simplelocalize-mcp",
        "--api-key=PROJECT_API_KEY"
      ]
    }
  }
}

Features (Tools)

Translation keys

  • Get translation keys
  • Create translation key
  • Update translation key
  • Delete translation key
  • Upload translation key screenshot (base64 or file)

Translations

  • Get translations
  • Update translation (single and bulk)

Auto-translation

  • Auto-translate text
  • Create auto-translation jobs
  • Get auto-translation jobs

Tags, languages & customers

  • Get/create/update/delete tags
  • Get/create/update/delete languages
  • Get/create/update/delete customers

Hosting & publishing

  • Get/create hosting environments
  • Get hosting environment details
  • Publish translations to hosting

Import, export & activity

  • Import translations from a local file
  • Export translations to downloadable file(s)
  • Get supported file formats
  • Get project activity

Glossary

  • Get glossary entries
  • Create glossary entry
  • Delete glossary entry

Project

  • Get project details

Feel free to add more tools by making a pull request or creating a feature request.

Installation

To use the MCP server, you'll need an API key. You can create and manage API keys in SimpleLocalize > Settings > Credentials -> Project API Key:

To run the server in a client like Claude Desktop, Cursor or Windsurf, add the following to your MCP config:

{
  "servers": {
    "simplelocalize": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@simplelocalize/simplelocalize-mcp", "--api-key=SIMPLELOCALIZE_API_KEY"]
    }
  }
}

Replace SIMPLELOCALIZE_API_KEY with your API key

For detailed setup guides, see:

Development

  1. Install dependencies:

    pnpm install

  2. Build the server:

    pnpm build

  3. Update client to use the local build:

    {
  "servers": {
    "simplelocalize": {
      "command": "node",
      "args": ["path/to/simplelocalize-mcp-server/build/index.js"],
      "env": {
        "SIMPLELOCALIZE_API_KEY": "your_api_key"
      }
    }
  }
}

Debugging

To debug the MCP server, you can use the MCP Inspector tool:

  1. Run the server with the inspector:

    pnpm inspector

  2. Open the provided URL in your browser to view and debug the MCP requests and responses.

  3. Include the --api-key argument.

Learn more

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.