PO Translation

Translates Django gettext .po files with AI, analyzes status, and validates updates with strict checks.

typescript

1

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "omert11-po-mcp": {
      "command": "node",
      "args": [
        "/path/to/po-mcp/dist/index.js"
      ]
    }
  }
}

You have a dedicated MCP Server that translates Django gettext .po files with AI assistance. It helps you analyze translation coverage, identify untranslated or fuzzy entries, and apply validated translations in a single operation, while preserving variables, HTML, URLs, and JavaScript constructs. This makes it easy to manage translations at scale with automated quality checks.

How to use

You interact with the MCP server through a client that can communicate with an MCP endpoint or a local stdio server. Start by analyzing a .po file to see translation status, then let AI generate translations for the untranslated entries, and finally validate and update the file in one step. Focus on practical workflows that you can repeat for multiple language files.

How to install

Prerequisites you need before installation:

# Node.js and npm are required
node -v
npm -v

Install dependencies and build the MCP server project:

npm install
npm run build

Configuration for MCP runtime

The MCP server runs as a stdio process. Use the following command to start the server locally. This command is derived from the runtime configuration that points to the built entry file.

node /path/to/po-mcp/dist/index.js

Notes on usage and workflow

Run the MCP server on your machine using the command above. 2) Use your MCP client to send analyze_po_file requests to obtain the list of untranslated and fuzzy entries. 3) Provide translations for the untranslated entries (or let the AI fill them) in the translations array. 4) Validate and update with a single operation to ensure all checks pass and the PO file is written back.

Security and validation considerations

The server includes strict validation checks when enabled to ensure translations preserve critical constructs such as variables, HTML tags, URLs, and JavaScript snippets. When you enable strict mode, the system validates all translations against these patterns before writing changes to disk.

Troubleshooting and tips

If the server cannot start, verify that the path to the built index file is correct and that Node.js has the appropriate permissions to execute the file. Ensure dependencies have been installed and the build completed successfully before starting the server.

Available tools

analyze_po_file

Analyze a .po file to retrieve translation status, including translated, untranslated, and fuzzy entries, along with a list of untranslated blocks.

validate_and_update_po_file

Validate the provided translations and update the .po file in one operation, returning a validation summary and the update result.