安裝
npx -y @mmntm/weblate-mcp適合誰
這份指南給已經擁有可存取 API 的 Weblate 實例、並想在對話裡查看專案與檢索翻譯單元的人。官方主路徑是 npx 啟動 @mmntm/weblate-mcp，並設定 WEBLATE_API_URL 與 WEBLATE_API_TOKEN。沒有實例位址和權杖時不要發起呼叫。
它適合先查看專案、再按 Weblate 原生過濾語法尋找翻譯的人。本頁明確寫出的工具是 listProjects 與 searchUnitsWithFilters。它不適合在尚未點名其它寫入工具時，被理解成可以隨意改譯文；沒寫到的工具名不要補造。
3 分鐘完成第一次嘗試
官方安裝命令如下。前置條件：本機可執行 npx（開發說明還寫了 Node.js 18+ 與 pnpm），以及一個帶 API access 的 Weblate instance。設定位置是用戶端 MCP 項：command 為 npx，args 為 -y 與 @mmntm/weblate-mcp，env 寫入 WEBLATE_API_URL 與 WEBLATE_API_TOKEN。URL 必須是你自己的 Weblate API 根路徑，不要使用文件裡的示例網域。
npx -y @mmntm/weblate-mcp
官方頁面：
https://github.com/mmntm/weblate-mcp
第一次嘗試使用官方工具 listProjects：查看全部可用 Weblate 專案及其 URL 與 metadata。成功信號是回傳專案，而不是權杖被拒絕。listProjects 會存取你設定的 Weblate 實例，不能理解成無網路或無隱私邊界。
使用案例
案例一：查看實例上有哪些專案。對應 listProjects。原文寫明會帶上 URLs and metadata，沒有寫出分頁或過濾參數；用戶端展示到哪一步就只用到那一步。成功時能看到專案名稱。
案例二：按過濾條件找翻譯單元。對應 searchUnitsWithFilters。官方寫明它使用 Weblate's native filtering syntax，並稱這是查找 translations 的高效方式。本頁沒有給出可複製的過濾運算式樣例，不要編造語法。成功信號是回傳匹配的翻譯單元。
使用邊界
傳輸方式在本頁包括 HTTP/SSE、Streamable HTTP 與 STDIO；沒有寫清預設埠，不要補造。金鑰與實例位址只放進本機 env。本頁沒有給出速率限制、可寫工具表或撤銷翻譯的步驟。開發側還提到 pnpm，那不是 npx 主路徑的替代安裝器，不要並列成兩套首選安裝。
呼叫 searchUnitsWithFilters 前，先確認過濾條件來自 Weblate 原生語法，而不是臨時編造的關鍵字。listProjects 只解決「實例上有哪些專案」，不會自動改任何譯文。