Install
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 인스턴스에 닿으므로 네트워크 없음이나 프라이버시 경계 없음으로 읽지 말 것.
사용 사례
사례 1: 인스턴스에 어떤 프로젝트가 있는지 본다. 대응은 listProjects. 원문은 URLs and metadata 를 붙인다고 하며 페이지나 필터 인자는 적지 않았다. 클라이언트가 보여주는 범위만 쓴다. 성공 시 프로젝트 이름이 보인다.
사례 2: 필터 조건으로 번역 단위를 찾는다. 대응은 searchUnitsWithFilters. 공식은 Weblate's native filtering syntax 를 쓰며 이것이 translations 를 찾는 효율적 방법이라고 한다. 이 페이지에 복사 가능한 필터 식 예시는 없으므로 구문을 만들지 말 것. 성공은 맞는 번역 단위가 돌아오는 것이다.
사용 경계
이 페이지의 전송 방식은 HTTP/SSE, Streamable HTTP, STDIO 를 포함한다. 기본 포트는 적혀 있지 않으니 만들지 말 것. 토큰과 인스턴스 주소는 로컬 env 에만 둔다. 속도 제한, 쓰기 도구 표, 번역 취소 단계는 이 페이지에 없다. 개발 쪽은 pnpm 도 언급하지만 npx 주 경로의 대체 설치기가 아니므로 두 가지 동등한 첫 선택으로 나란히 두지 말 것.
searchUnitsWithFilters 를 호출하기 전에 필터가 Weblate 네이티브 구문에서 온 것인지 확인하고, 즉석 키워드를 만들지 말 것. listProjects 는 인스턴스의 프로젝트만 답하며 번역문을 자동으로 바꾸지 않는다.