upstash/context7 소개…최신 라이브러리 문서를 LLM·Cursor에 주입하는 MCP/CLI

LLM과 Cursor 같은 코딩 에이전트는 학습 컷오프 이후의 API를 자주 환각합니다. upstash/context7(Context7)는 버전별 최신 라이브러리 문서·예제를 소스에서 가져와 프롬프트에 주입하는 MCP/CLI입니다. “use context7” 한 줄로 Next.js·Supabase·Cloudflare Worker 등의 최신 패턴을 붙이는 흐름이 README의 핵심 메시지입니다.

없는 세상 vs 있는 세상

• Without: 1년 전 예제, 없는 API, 구버전 일반론
• With: 라이브러리 ID 기준 최신 문서 조각을 컨텍스트에 직접 삽입

도구 구성

MCP

• resolve-library-id — 라이브러리 이름 → Context7 ID (예: /vercel/next.js)
• query-docs — libraryId + 질문으로 관련 문서 검색

CLI (ctx7)

• ctx7 library <name> <query>
• ctx7 docs <libraryId> <query>

원격 MCP 엔드포인트는 https://mcp.context7.com/mcp 입니다.

설치 팁 (Cursor / Claude)

# 대화형 설정(권장): OAuth·API 키·스킬/MCP 모드 선택
npx ctx7 setup
# 특정 에이전트만
npx ctx7 setup --cursor
npx ctx7 setup --claude

수동 연결 시 MCP 클라이언트에 URL https://mcp.context7.com/mcp를 등록하고, API 키는 Authorization: Bearer YOUR_API_KEY로 전달합니다. 무료 키는 context7.com 대시보드에서 발급(레이트리밋 완화에 유리).

패키지: MCP는 @upstash/context7-mcp, CLI는 ctx7.

에이전트 규칙 예시

라이브러리 API·설정 질문에는 Context7로 문서 조회 후 답한다.
사용자가 명시하지 않아도 최신 공식 문서 기준으로 맞춘다.

실전 사용 예

• “Next.js middleware에서 쿠키 JWT 검증 후 /login 리다이렉트 — use context7”
• “Supabase email/password 가입 API 최신 시그니처 보여줘”
• 먼저 resolve-library-id로 ID를 확정한 뒤 query-docs

주의

• 인덱스는 커뮤니티·크롤 기반이라 품질·보안을 100% 보장하지 않는다고 공식 Disclaimer에 명시
• 의심스러운 문서는 프로젝트 페이지 Report, 그리고 공식 문서 URL과 교차 확인
• 이 공개 저장소는 MCP 소스 중심이며 API·파서·크롤러 백엔드는 private

Cursor MCP 수동 JSON 예시

{
  "mcpServers": {
    "context7": {
      "url": "https://mcp.context7.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

클라이언트마다 URL형·stdio형 설정 키가 다르므로, 공식 “MCP Clients” 문서에서 Cursor/Claude 항목을 확인하세요. API 키는 저장소에 커밋하지 말고 로컬/시크릿에만 둡니다.

FAQ

Q. MCP만 쓰나요?
A. CLI+Skills 모드도 있습니다. setup 과정에서 선택하세요.

Q. 사내 라이브러리도?
A. 공개 인덱스 제출 절차(Adding Libraries)가 있습니다. 사내망은 별도 검토가 필요합니다.

Q. 왜 훈련 데이터보다 낫나요?
A. 컷오프 이후 breaking change를 문서에서 직접 가져오기 때문입니다.

핵심 정리

• resolve-library-id → query-docs 로 최신 문서 주입
• npx ctx7 setup 또는 MCP URL https://mcp.context7.com/mcp
• 환각 API를 줄이는 실무형 MCP

출처

GitHub: https://github.com/upstash/context7 · 사이트: https://context7.com