Ver projetos Weblate e procurar traduções no chat

Para quem

Este guia é para quem já tem uma instância Weblate com API alcançável e quer ver projetos e procurar unidades de tradução no chat. O caminho oficial principal é iniciar @mmntm/weblate-mcp com npx e configurar WEBLATE_API_URL e WEBLATE_API_TOKEN. Sem URL de instância e token não chame nada.

Serve a quem primeiro mostra projetos e depois encontra traduções com a sintaxe de filtro nativa do Weblate. As ferramentas que esta página nomeia por completo são listProjects e searchUnitsWithFilters. Não sirva ler ferramentas de escrita não citadas como autorização para mudar traduções; não invente nomes de ferramentas que não estejam escritos.

Primeira tentativa em 3 minutos

O comando oficial de instalação segue. Pré-requisitos: npx executável aqui (as notas de desenvolvimento também mencionam Node.js 18+ e pnpm) e uma Weblate instance com API access. A configuração é o item MCP do cliente: command é npx, args são -y e @mmntm/weblate-mcp, env guarda WEBLATE_API_URL e WEBLATE_API_TOKEN. O URL tem de ser a raiz API do seu Weblate; não use nomes de anfitrião de exemplo da documentação.

npx -y @mmntm/weblate-mcp

Página oficial:

https://github.com/mmntm/weblate-mcp

Na primeira tentativa use a ferramenta oficial listProjects: mostre todos os projetos Weblate disponíveis com o respetivo URL e metadata. O sucesso é voltarem projetos, não um token recusado. listProjects alcança a instância Weblate configurada; não leia isso como sem rede nem sem limite de privacidade.

Casos de uso

Caso 1: ver que projetos existem na instância. Corresponde a listProjects. O texto oficial diz URLs and metadata e não nomeia paginação nem parâmetros de filtro; use só o que o cliente mostrar. No sucesso veem-se os nomes dos projetos.

Caso 2: encontrar unidades de tradução por filtro. Corresponde a searchUnitsWithFilters. O oficial diz que usa Weblate's native filtering syntax e que é uma forma eficiente de encontrar translations. Esta página não dá uma expressão de filtro copiável; não invente sintaxe. O sucesso é voltarem unidades correspondentes.

Limites de uso

Os transportes nomeados aqui incluem HTTP/SSE, Streamable HTTP e STDIO; não há porta predefinida escrita, não invente uma. Token e URL de instância só no env local. Esta página não dá limites de ritmo, tabela de ferramentas de escrita nem passos para anular uma tradução. O lado de desenvolvimento também menciona pnpm; não é um instalador principal substituto do caminho npx, não os coloque como duas primeiras escolhas iguais.

Antes de chamar searchUnitsWithFilters, confirme que o filtro vem da sintaxe nativa do Weblate, não de uma palavra improvisada. listProjects só responde que projetos existem na instância e não altera nenhuma tradução sozinho.