resxmcp: Lightweight MCP Server for .NET .resx Multilingual Resource Editing

Resxmcp

A lightweight MCP server for managing .NET localization resource files (.resx), supporting read, write, and modification operations on multi-language resources

Developer tools Language translation #Resource Management #Localization #MCP Tool .C#

rating : 2 points

downloads : 6.4K

update time : 2025-11-12

Open Site

What is ResxMcp?

ResxMcp is a localization resource file management tool specifically designed for .NET projects. It enables AI assistants to intelligently help you manage multi-language resource files through the Model Context Protocol (MCP) standard, achieving automatic translation, content updates, and version control.

How to use ResxMcp?

ResxMcp runs as a local MCP server and can be seamlessly integrated with AI development tools such as Gemini CLI, Claude Desktop, and Cursor IDE. You can use simple commands to let the AI assistant help you manage multi-language resource files.

Applicable Scenarios

Suitable for .NET project development requiring multi-language support, international application development, team collaboration translation management, and development scenarios where AI automation is used to process localization resource files.

Main Features

Read .resx Files

Securely read the content of .resx files in UTF-8 encoding, supporting viewing resources in all language versions

Write .resx Files

Atomic write operations with an optional backup function to ensure the security of file operations

Manage Resource Entries

Add, update, and delete resource key-value pairs, supporting comment management

Multi-Client Support

Compatible with all MCP client tools, including Gemini CLI, Claude Desktop, etc.

Version Control Friendly

The output format is friendly to version control systems, facilitating team collaboration and code review

Advantages

Safe operation: All write operations are atomic and support automatic backup

Easy integration: Seamlessly integrated with mainstream AI development tools

Multi-language support: Professionally handle .NET localization resource files

Development efficiency: Significantly improve localization management efficiency through AI automation

Open source and free: Based on the MIT license and completely free to use

Limitations

Only supports the Windows platform (.NET 8.0)

Requires basic command-line operation knowledge

Relies on MCP client tools to fully发挥 its functions

Primarily targets the .resx file format of .NET projects

How to Use

Build the Project

Build and publish the ResxMcp server using the .NET CLI

Verify the Installation

Confirm that the tool is correctly installed and available

Start Using

Call the ResxMcp tool through the AI assistant to manage your .resx files

Usage Examples

Localization of Multi-Language Applications

Add multi-language support to a .NET application, create and maintain resource files in different language versions

Batch Update of Application Text

When you need to update the text content in an application, update the corresponding entries in all language versions simultaneously

Translation Consistency Check

Check the consistency and completeness of translations between different language versions

Frequently Asked Questions

What is the difference between ResxMcp and directly editing .resx files?

Do I need programming knowledge to use it?

Which language files are supported?

How is data security ensured?

Does it support team collaboration?

Related Resources

GitHub Repository

Project source code and the latest version

Model Context Protocol Documentation

Official documentation of the MCP protocol

.NET Localization Guide

Microsoft's official .NET localization development guide

Gemini CLI Documentation

Documentation for the integration of Gemini CLI and MCP

🚀 ResxMcp

A lightweight MCP server for managing .resx localization files

🚀 Quick Start

Build your .NET project with localization resources.
Use resx.read to inspect .resx content.
Modify, translate, or generate .resx files automatically with your MCP tools.
Use resx.write or resx.setEntry to update keys or values.

✨ Features

✅ Read .resx files as UTF-8 text ✅ Atomic write with optional .bak backup ✅ Add / update / remove resource keys ✅ Works with all MCP clients ✅ Diff-friendly deterministic output

📦 Installation

⚠️ Important Note

Some users may try to install this project with:

gemini extensions install https://github.com/miaofalianhua/ResxMcp

⚠️ Do NOT do this repeatedly! This command triggers Google’s extension registry verification and may result in rate limit errors (HTTP 429) or installation failure.

👉 The correct way to use ResxMcp is as a local MCP server, not a regular Gemini extension.

✅ Recommended Installation

1️⃣ Build the project

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

2️⃣ Register with Gemini CLI

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

3️⃣ Verify installation

gemini @resx-tool tools/list

You should see tools such as: resx.read, resx.write, resx.setEntry, and resx.removeEntry.

💡 Tip: If you wish to distribute it as an installable Gemini extension, use the included gemini-extension.json (v1.0.2). It wraps this MCP server for one-command installation when the registry supports MCP-only extensions.

💻 Usage Examples

Basic Usage

gemini @resx-tool tools/call resx.setEntry --arguments '{"file":"lang.zh-CN.resx","name":"App.Title","value":"Triad Controls"}'

🎬 Visual Walkthrough

Editing multi-language .resx via Gemini CLI + ResxMcp

Step 1 — Update Strings.resx (neutral/en):

Step 2 — Update Strings.zh-CN.resx (Simplified Chinese):

Step 3 — Update Strings.ja-JP.resx (Japanese):

✅ Step 4 — Final Multilingual Result: Below is the merged multilingual view of all .resx files.

🧭 Overview

ResxMcp is a minimal MCP (Model Context Protocol) compatible tool server that allows safe read / write / modify operations on .resx files. It works with any MCP client such as Gemini CLI, Claude Desktop, or Cursor IDE.

🧰 Available Tools

Property	Details
`resx.read`	Read `.resx` as UTF-8 text. Parameters: `{ "file": "path/to/file.resx" }`
`resx.write`	Write UTF-8 text (atomic replace). Parameters: `{ "file": "path/to/file.resx", "content": "<xml>", "backup": true }`
`resx.setEntry`	Add or update a key/value pair. Parameters: `{ "file": "path/to/file.resx", "name": "Key", "value": "Value", "comment": "Optional" }`
`resx.removeEntry`	Remove a key from `.resx`. Parameters: `{ "file": "path/to/file.resx", "name": "Key" }`

🧩 Integration

ResxMcp communicates over stdio (JSON-RPC), so it can be used by any modern AI-assisted development tool or automation pipeline following the MCP standard.

Compatible with: