Resxmcp

🚀 🌐 ResxMcp

ResxMcp 是一個輕量級的 MCP 服務器，用於管理 .resx 本地化資源文件，能安全地對 .resx 文件進行讀寫和修改操作，可與各類 MCP 客戶端配合使用。

🚀 快速開始

1. 構建包含本地化資源的 .NET 項目。
2. 使用 resx.read 查看 .resx 文件內容。
3. 藉助 MCP 工具自動修改、翻譯或生成 .resx 文件。
4. 使用 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）配合使用。

🧰 可用工具

🧩 集成

ResxMcp 通過 標準輸入輸出（JSON-RPC） 進行通信，因此它可被任何遵循 MCP 標準的現代 AI 輔助開發工具 或 自動化流程 使用。

兼容以下工具：

• 🪄 Gemini CLI
• 🧠 Claude Desktop
• 🧰 Cursor IDE
• ⚙️ 任何基於 MCP 的自定義工作流

📄 許可證

本項目採用 MIT 許可證。

✨ 作者

斌哥 (Miaofalianhua)
🌍 GitHub: @miaofalianhua
🧠 專注領域：C#、本地化、AI 輔助開發

💡 ResxMcp 將經典的 .NET 本地化與現代 AI 工作流相連接 —— 簡單、安全且開放。