Scan to join WeChat groupREADME
🚀 🌐 ResxMcp
ResxMcp 是一个轻量级的 MCP 服务器，用于管理 .resx 本地化资源文件，能安全地对 .resx 文件进行读写和修改操作，可与各类 MCP 客户端配合使用。
🚀 快速开始
- 构建包含本地化资源的 .NET 项目。
- 使用
resx.read查看.resx文件内容。 - 借助 MCP 工具自动修改、翻译或生成
.resx文件。 - 使用
resx.write或resx.setEntry更新键值。
✨ 主要特性
- ✅ 以 UTF-8 文本格式读取
.resx文件。 - ✅ 支持原子写入，并可选择创建
.bak备份文件。 - ✅ 可添加、更新或删除资源键。
- ✅ 能与所有 MCP 客户端协同工作。
- ✅ 输出结果具有确定性，便于进行差异比较。
📦 安装指南
⚠️ 安装注意事项
部分用户可能会尝试使用以下命令安装本项目：
gemini extensions install https://github.com/miaofalianhua/ResxMcp
⚠️ 请勿重复执行此操作！ 该命令会触发 Google 的扩展注册表验证，可能导致 速率限制错误（HTTP 429） 或 安装失败。
👉 正确使用 ResxMcp 的方式是将其作为 本地 MCP 服务器，而非普通的 Gemini 扩展。
✅ 推荐安装步骤
1️⃣ 构建项目
dotnet publish -c Release -r win-x64 -p:PublishSingleFile=true -o ./publish
2️⃣ 在 Gemini CLI 中注册
gemini mcp add resx-tool "./publish/ResxMcp.exe"
3️⃣ 验证安装
gemini @resx-tool tools/list
你应该能看到 resx.read、resx.write、resx.setEntry 和 resx.removeEntry 等工具。
💡 提示：如果你想将其作为可安装的 Gemini 扩展进行分发，可使用附带的 gemini-extension.json（v1.0.2）。当注册表支持仅含 MCP 的扩展时，它可将此 MCP 服务器封装为一键安装包。
💻 使用示例
gemini @resx-tool tools/call resx.setEntry --arguments '{"file":"lang.zh-CN.resx","name":"App.Title","value":"Triad Controls"}'
📚 详细文档
🎬 可视化操作指南
通过 Gemini CLI + ResxMcp 编辑多语言 .resx 文件
步骤 1 — 更新 Strings.resx（中性/英语）
步骤 2 — 更新 Strings.zh-CN.resx（简体中文）
步骤 3 — 更新 Strings.ja-JP.resx（日语）
✅ 步骤 4 — 最终多语言结果
以下是所有 .resx 文件合并后的多语言视图。
🧭 概述
ResxMcp 是一个最小化的 MCP（模型上下文协议） 兼容工具服务器，允许对 .resx 文件进行安全的 读取/写入/修改 操作。它可与任何 MCP 客户端（如 Gemini CLI、Claude Desktop 或 Cursor IDE）配合使用。
🧰 可用工具
| 工具 | 描述 | 参数 |
|------|------|------|
| resx.read | 以 UTF-8 文本格式读取 .resx 文件 | { "file": "path/to/file.resx" } |
| resx.write | 写入 UTF-8 文本（原子替换） | { "file": "path/to/file.resx", "content": "<xml>", "backup": true } |
| resx.setEntry | 添加或更新键值对 | { "file": "path/to/file.resx", "name": "Key", "value": "Value", "comment": "Optional" } |
| resx.removeEntry | 从 .resx 文件中移除键 | { "file": "path/to/file.resx", "name": "Key" } |
🧩 集成
ResxMcp 通过 标准输入输出（JSON-RPC） 进行通信，因此它可被任何遵循 MCP 标准的现代 AI 辅助开发工具 或 自动化流程 使用。
兼容以下工具：
- 🪄 Gemini CLI
- 🧠 Claude Desktop
- 🧰 Cursor IDE
- ⚙️ 任何基于 MCP 的自定义工作流
📄 许可证
本项目采用 MIT 许可证。
✨ 作者
斌哥 (Miaofalianhua)
🌍 GitHub: @miaofalianhua
🧠 专注领域：C#、本地化、AI 辅助开发
💡 ResxMcp 将经典的 .NET 本地化与现代 AI 工作流相连接 —— 简单、安全且开放。