Supercharging Adobe Commerce development: introducing the adobe-commerce-docs-mcp server

개요

Adobe Commerce 및 Magento 2 개발자를 위해 IDE에서 공식 Adobe 문서를 직접 검색하고 활용할 수 있도록 설계된 adobe-commerce-docs-mcp 서버가 소개됩니다.

주요 내용

• 개발 생산성 향상: 느린 빌드 시간, 정적 콘텐츠 배포, 특히 문서 검색에 소요되는 시간을 줄여 개발자의 집중력을 유지하도록 돕습니다.
• 직접 문서 접근: Cursor, Claude Desktop, VS Code, Windsurf와 같은 IDE와 직접 연동하여 공식 Adobe Experience League 사이트의 최신 마크다운 문서를 IDE의 채팅 컨텍스트로 가져옵니다.
• AI 기반 검색 아키텍처: 웹 검색이나 오래된 학습 데이터에 의존하는 대신, 실시간 Adobe Experience League 사이트를 쿼리하고 로컬로 내용을 인덱싱하며 페이지를 캐싱합니다.
• BM25 검색 랭킹: 검색어 빈도와 문서 길이를 고려하여 가장 관련성 높은 문서를 우선적으로 제공하는 BM25 알고리즘을 사용하여 검색 정확도를 높입니다.
• 동의어 및 퍼지 매칭: 'graphql'은 'gql'로, 'cloud'는 'ece'와 같이 Magento 관련 동의어를 인식하고 'chekout', 'catlog'과 같은 오타도 수정하여 검색의 유연성을 확보합니다.
• 로컬 캐싱: 최근 쿼리에 대한 인메모리 캐시와 디스크에 영구 저장되는 파일 캐시의 두 가지 계층을 사용하여 네트워크 요청 속도를 높이고 API 호출을 줄입니다. 사이트맵 데이터는 24시간, 다운로드된 페이지는 7일간 캐싱됩니다.
• 9가지 내장 도구: search_adobe_commerce_docs, get_doc_content, get_code_examples, get_page_toc, get_related_docs, lookup_error_code, multi_page_search, list_doc_sections, refresh_sitemap 등 문서 검색, 콘텐츠 추출, 오류 코드 조회, 관련 문서 탐색 등 다양한 작업을 수행하는 도구를 제공합니다.
• 4가지 준비된 프롬프트: troubleshoot-commerce-error, explain-commerce-concept, commerce-code-review, commerce-upgrade-guide와 같은 내장 프롬프트를 통해 일반적인 워크플로우를 자동화합니다.
• 간편한 설치: 별도의 코드 빌드 없이 npx를 통해 서버를 실행할 수 있으며, Cursor 사용자를 위한 원클릭 설치 스크립트를 제공합니다. 수동 구성도 가능합니다.
• 환경 변수 설정: SITEMAP_URL, CACHE_DIR, SITEMAP_CACHE_TTL_MS, PAGE_DISK_CACHE_TTL_MS, MAX_CONTENT_LENGTH, PORT 등 환경 변수를 통해 서버 동작을 맞춤 설정할 수 있습니다.
• 예시 활용: 자연어 쿼리를 통해 GraphQL 뮤테이션 코드 예시를 찾거나, 특정 오류 코드를 진단하고 수정 방법을 알아보거나, 플러그인 구성을 모범 사례에 맞춰 검토하는 등 다양한 시나리오에서 활용될 수 있습니다.

시사점

adobe-commerce-docs-mcp 서버는 Adobe Commerce 및 Magento 2 개발자가 IDE 내에서 직접 공식 문서를 활용하여 개발 효율성을 극대화하고 시간 소모적인 정보 검색 과정을 최소화할 수 있는 실질적인 해결책을 제시합니다.