安装
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 只解决“实例上有哪些项目”，不会自动改任何译文。