金大哥 - resxmcp MCP 详情

article

README

🚀 🌐 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 工作流相连接 —— 简单、安全且开放。

resxmcp