Community코딩 & 개발github.com

Murzav/xcstrings-mcp

iOS/macOS .xcstrings 현지화를 위한 MCP 서버 및 CLI — 전체 생애주기를 지원하는 26개의 MCP 도구와 11개의 CLI 명령어: 생성 → 추출 → 번역 → 검증 → 내보내기

xcstrings-mcp란 무엇인가요?

Murzav/xcstrings-mcp는 iOS와 macOS 애플리케이션의 .xcstrings 현지화 파일을 관리하기 위한 MCP (Model Context Protocol) 서버이자 CLI 도구입니다. 이 스킬은 26개의 MCP 도구와 11개의 CLI 명령어를 제공하여 현지화 작업의 전체 생애주기(생성, 추출, 번역, 검증, 내보내기)를 자동화합니다. AI 어시스턴트(예: Claude Code, Cursor)와 함께 사용하면 번역 누락 검사, 키 관리, 다국어 번역 생성, 유효성 검증 등을 명령어 한 번으로 수행할 수 있어 개발자의 현지화 워크플로우를 크게 간소화합니다. SKILL.md 문서에는 각 MCP 도구와 CLI 명령어에 대한 상세한 사용법, 예시, 그리고 구성 옵션이 포함되어 있으며, 사용자는 이를 통해 복잡한 현지화 프로세스를 효율적으로 관리할 수 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add Murzav/xcstrings-mcp

Installed? Explore more 코딩 & 개발 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

xcstrings-mcp은(는) 무엇을 하나요?

iOS/macOS .xcstrings 현지화를 위한 MCP 서버 및 CLI — 전체 생애주기를 지원하는 26개의 MCP 도구와 11개의 CLI 명령어: 생성 → 추출 → 번역 → 검증 → 내보내기

개요

이 도구는 Apple의 .xcstrings 현지화 파일 형식을 다루기 위한 MCP 서버 및 CLI를 제공합니다. AI 어시스턴트와 통합되어 현지화 작업을 자동화하고 관리합니다.

기능

  • 26개의 MCP 도구: AI 어시스턴트가 직접 호출할 수 있는 다양한 현지화 작업
  • 11개의 CLI 명령어: 터미널에서 직접 실행 가능한 명령어
  • 전체 생애주기 지원: 생성, 추출, 번역, 검증, 내보내기

설치

npm install -g @murzav/xcstrings-mcp

또는 로컬에서 사용:

npx @murzav/xcstrings-mcp

사용법

MCP 서버로 실행

xcstrings-mcp serve

CLI로 실행

xcstrings-mcp [명령어] [옵션]

MCP 도구 목록

도구 이름설명
create_xcstrings새로운 .xcstrings 파일 생성
extract_strings소스 코드에서 문자열 추출
translate_file파일 전체 번역
validate_file.xcstrings 파일 유효성 검증
export_file다른 형식으로 내보내기

(전체 목록은 26개 도구 포함)

CLI 명령어 목록

명령어설명
create새 .xcstrings 파일 생성
extract소스 코드에서 문자열 추출
translate번역 실행
validate유효성 검증
export내보내기

(전체 목록은 11개 명령어 포함)

환경 변수

  • OPENAI_API_KEY: 번역에 OpenAI 사용 시 필요
  • DEEPL_API_KEY: 번역에 DeepL 사용 시 필요
  • LOCAL_MODEL: 로컬 번역 모델 지정 시 사용

예시

새 현지화 파일 생성

xcstrings-mcp create --locale ko --directory ./Resources

소스 코드에서 문자열 추출

xcstrings-mcp extract --source ./Sources --output ./Resources/Localizable.xcstrings

번역 실행

xcstrings-mcp translate --file ./Resources/Localizable.xcstrings --target-languages ko,ja,zh-Hans

유효성 검증

xcstrings-mcp validate --file ./Resources/Localizable.xcstrings

다른 형식으로 내보내기

xcstrings-mcp export --file ./Resources/Localizable.xcstrings --format csv --output ./Exports/localization.csv

라이선스

MIT

관련 스킬