ResxMcp Server

Provides read/write/modify access to .resx localization files via MCP clients for safe, deterministic localization work.

other

1

GitHub Stars

other

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": {
    "miaofalianhua-resxmcp": {
      "command": "./publish/ResxMcp.exe",
      "args": []
    }
  }
}

ResxMcp is a lightweight MCP server that lets you safely read, write, and modify .resx localization files through any MCP client. It enables precise, atomic updates to translation resources while keeping your localization workflow efficient and scriptable.

How to use

You interact with ResxMcp through an MCP client, such as Gemini CLI, Claude Desktop, or Cursor IDE. Use the client to call the available resx endpoints to read a .resx file, add or update a key/value pair, remove a key, or write entire content atomically. The server exposes commands for reading UTF-8 encoded .resx files, performing atomic writes (with an optional backup), and manipulating individual resource entries. Your workflow can translate strings, generate new keys, and keep all language files in sync by issuing the appropriate resx.read, resx.setEntry, resx.write, or resx.removeEntry calls in sequence.

Key capabilities you will use include: reading a .resx file to inspect current values, adding or updating a Key/Value pair, removing a key, and performing atomic writes to save changes with optional backups. Use diff-friendly output to compare changes between languages and ensure translations stay aligned across locales.

How to install

Prerequisites you need before installation: a .NET runtime environment (for building and publishing) and a MCP client to register and interact with the server.

Build the project for a single-file executable so you can run it locally.

dotnet publish -c Release -r win-x64 -p:PublishSingleFile=true -o ./publish

Register the MCP server with your MCP client manager so you can discover and call its tools.

gemini mcp add resx-tool "./publish/ResxMcp.exe"

Verify the installation by listing available tools exposed by the new MCP server.

gemini @resx-tool tools/list

Additional notes

Environment considerations: there are no required environment variables shown for running the server. If you extend your setup later with environment-based configuration, document those values in your deployment notes.

Usage tips: after starting the server, you can use the resx.read endpoint to inspect a file, then use resx.setEntry to add or update keys, and resx.write or resx.removeEntry to apply changes atomically. You can enable backup behavior during writes to safeguard against accidental loss.

Available tools

resx.read

Read a .resx file as UTF-8 text to inspect its resources.

resx.write

Write UTF-8 text to a .resx file atomically, with an optional backup.

resx.setEntry

Add or update a key/value pair in a .resx file, with an optional comment.

resx.removeEntry

Remove a key from a .resx file.