AI 코딩 에이전트는 웹 앱에 국제화를 처음부터 설정하려고 하면 쉽게 막히곤 합니다. 로캘 라우팅, 미들웨어, 번역 파일, 프로바이더 래퍼, 언어 전환기처럼 서로 맞물린 단계가 많다 보니, 무엇을 끝냈고 무엇이 남았는지 놓치기 쉽습니다.
Sequential Thinking MCP에서 영감을 받아, i18n 설정을 에이전트가 단계별로 따라갈 수 있는 가이드형 체크리스트로 나누는 무료 MCP 서버를 만들었습니다. AI 에이전트에 연결한 뒤 "Set up i18n,"이라고 입력하면 전체 설정이 몇 분 안에 완료됩니다.
MCP가 제공하는 것#
이 서버는 AI 에이전트에 네 가지 도구를 제공합니다:
| 도구 | 용도 |
|---|---|
i18n_checklist | 전체 설정을 조율하는 단계별 구현 가이드입니다. 에이전트는 각 단계마다 이 도구를 호출해 다음에 무엇을 해야 할지 확인합니다. |
get_project_context | 프로젝트의 아키텍처(프레임워크, 라우터, 디렉터리 구조)를 파악해 구현 전략에 반영합니다. |
get_framework_docs | 감지된 프레임워크(Next.js, React Router, TanStack Start)의 공식 문서를 가져옵니다. |
get_i18n_library_docs | 프로바이더와 컴포넌트 설정에 사용하는 i18n 라이브러리(예: react-intl) 문서를 가져옵니다. |
i18n_checklist 도구는 전체 흐름을 조율하는 역할을 합니다. 프로젝트 분석부터 로캘 라우팅, 번역 설정, 언어 전환기, 빌드 검증까지 총 13단계에 걸쳐 에이전트를 안내합니다. 각 단계마다 무엇을 구현해야 하는지, 어떤 도구를 호출해야 하는지 정확히 알려줍니다.
구현되는 항목#
일반적으로 MCP의 안내에 따라 설정하면 다음이 구현됩니다:
- 로캘 인식 라우트 - 활성 로캘이 접두사로 붙는 URL(
/en/about,/es/about) - 언어 전환기 - 지원하는 로캘 사이를 전환하는 UI 컴포넌트
- 로캘 감지 - 사용자의 선호 언어를 자동으로 감지
- 번역 인프라 - 프로바이더 설정, 번역 파일, 헬퍼 함수
지원 프레임워크#
| 프레임워크 | 버전 |
|---|---|
| Next.js App Router | v13-16 |
| Next.js Pages Router | v13-16 |
| TanStack Start | v1 |
| React Router | v7 |
사용법#
MCP를 AI 코딩 어시스턴트에 연결한 뒤, 다음처럼 프롬프트를 입력하세요:
Set up i18n
또는 로캘을 구체적으로 지정할 수도 있습니다:
Set up i18n with the following locales: en, es, and pt-BR. The default locale is "en".
에이전트는 먼저 i18n_checklist를 호출해 시작한 뒤, 안내된 단계에 따라 진행하면서 필요할 때 다른 도구를 호출합니다. 그 결과 프레임워크와 프로젝트 구조에 맞는 작동하는 i18n 설정이 완성됩니다.
AI 지원 코딩은 본질적으로 비결정적입니다. MCP는 체크리스트 기반 접근 방식으로 일관성을 높여 주지만, 실행할 때마다 결과는 달라질 수 있습니다.
