0.1.0 • Published 2 months ago

@simplelocalize/simplelocalize-mcp v0.1.0

Weekly downloads
-
License
Apache-2.0
Repository
github
Last release
2 months ago

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.

Features (Tools)

  • Create translation key
  • Update translation key
  • Update translations bulk
  • Get all translation keys
  • Get translation key details
  • Get tags
  • Create tag
  • Get languages
  • Get translations

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:

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

{
  "mcpServers": {
    "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:

    {
      "mcpServers": {
        "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