documentation-lookup

문서 조회 (Context7)

사용자가 라이브러리, 프레임워크, API를 묻는다면 학습 데이터에 기대지 말고 Context7 MCP 도구(resolve-library-id, query-docs)로 현재 문서를 가져옵니다.

핵심 개념

• Context7: 라이브 문서를 노출하는 MCP 서버입니다. 라이브러리와 API 관련 정보는 학습 데이터 대신 이것을 사용합니다.
• resolve-library-id: 라이브러리 이름과 질의로부터 Context7 호환 라이브러리 ID(예: /vercel/next.js)를 반환합니다.
• query-docs: 특정 라이브러리 ID와 질문에 대한 문서와 코드 스니펫을 가져옵니다. 유효한 라이브러리 ID를 얻기 위해 항상 먼저 resolve-library-id를 호출합니다.

사용 시점

다음 상황에서 활성화합니다.

• 설정이나 구성 방법을 묻는 경우
  • 예: "Next.js middleware는 어떻게 설정해?"
• 라이브러리에 의존하는 코드가 필요한 경우
  • 예: "Prisma로 이런 쿼리 작성해줘"
• API나 레퍼런스 정보가 필요한 경우
  • 예: "Supabase auth 메서드가 뭐가 있지?"
• 특정 프레임워크나 라이브러리 이름이 언급된 경우
  • React, Vue, Svelte, Express, Tailwind, Prisma, Supabase 등

요청이 라이브러리, 프레임워크, API의 정확하고 최신 동작에 의존한다면 이 스킬을 사용합니다. Context7 MCP가 설정된 모든 하니스에 적용됩니다.

동작 방식

1단계: 라이브러리 ID 해석

다음 값으로 resolve-library-id MCP 도구를 호출합니다.

• libraryName: 사용자 질문에서 가져온 라이브러리 또는 제품 이름
  • 예: Next.js, Prisma, Supabase
• query: 사용자의 전체 질문

먼저 Context7 호환 라이브러리 ID(/org/project 또는 /org/project/version)를 확보해야 합니다. 이 단계에서 유효한 ID를 얻기 전에는 query-docs를 호출하지 않습니다.

2단계: 최적 일치 선택

해석 결과에서 다음 기준으로 하나를 고릅니다.

• 이름 일치도: 사용자가 요청한 이름과 정확히 맞거나 가장 가까운 항목을 우선합니다.
• Benchmark 점수: 높을수록 문서 품질이 좋습니다. 100이 최고입니다.
• Source reputation: 가능하면 High 또는 Medium 평판을 우선합니다.
• Version: 사용자가 버전을 명시했다면 버전 지정 라이브러리 ID를 우선합니다.
  • 예: React 19, Next.js 15

3단계: 문서 가져오기

다음 값으로 query-docs MCP 도구를 호출합니다.

• libraryId: 2단계에서 선택한 Context7 라이브러리 ID
  • 예: /vercel/next.js
• query: 사용자의 구체적인 질문 또는 작업

호출 제한은 질문당 최대 3회입니다. 3번 호출 후에도 답이 불명확하면 추측하지 말고 불확실성을 명시한 뒤 확보한 최선의 정보로 답합니다.

4단계: 문서 활용

• 가져온 최신 정보로 사용자 질문에 답합니다.
• 도움이 되면 관련 코드 예제를 함께 제공합니다.
• 버전이 중요하면 라이브러리나 버전을 답변에 명시합니다.
  • 예: "Next.js 15에서는..."

예시

예시: Next.js middleware

1. libraryName: "Next.js", query: "How do I set up Next.js middleware?"로 resolve-library-id를 호출합니다.
2. 결과에서 이름과 benchmark 점수를 기준으로 최적 항목을 선택합니다.
3. 해당 libraryId와 같은 질문으로 query-docs를 호출합니다.
4. 반환된 스니펫과 설명을 바탕으로 답하고, 적절하면 최소한의 middleware.ts 예제를 함께 제시합니다.

예시: Prisma 쿼리

1. libraryName: "Prisma", query: "How do I query with relations?"로 resolve-library-id를 호출합니다.
2. 공식 Prisma 라이브러리 ID를 선택합니다.
3. 그 libraryId와 질의로 query-docs를 호출합니다.
4. include 또는 select 패턴 같은 Prisma Client 사용법을 짧은 코드 예제와 함께 반환합니다.

예시: Supabase auth 메서드

1. libraryName: "Supabase", query: "What are the auth methods?"로 resolve-library-id를 호출합니다.
2. Supabase 문서 라이브러리 ID를 고릅니다.
3. query-docs를 호출한 뒤 auth 메서드를 요약하고 최소 예제를 보여줍니다.

모범 사례

• 구체적으로 묻기: 관련도를 높이기 위해 가능하면 사용자의 전체 질문을 그대로 query에 넣습니다.
• 버전 인식: 사용자가 버전을 언급하면 해석 단계에서 버전 지정 라이브러리 ID를 우선합니다.
• 공식 소스 우선: 후보가 여러 개면 커뮤니티 포크보다 공식/원천 패키지를 우선합니다.
• 민감 정보 금지: Context7에 보내는 질의에는 API 키, 비밀번호, 토큰 같은 비밀을 포함하지 않습니다. resolve-library-id나 query-docs 호출 전에 사용자 질문에 시크릿이 섞였을 가능성을 먼저 점검합니다.