Context7 MCP 설치하고 써본 후기

기존 AI 코딩의 한계

AI 코딩 도구를 써본 사람이라면 이런 일을 한 번쯤은 겪어봤을 것이다.

• Deprecated API 추천 — React Query v3 문법을 v5 프로젝트에 제안
• 할루시네이션 — 실제로 존재하지 않는 함수나 옵션을 생성
• 버전 미고려 — Next.js Pages Router 코드를 App Router 프로젝트에 제안
• 정적 학습 데이터 — 훈련 데이터 커트오프 이후의 변경사항 반영 불가

이런 문제들은 결국 AI가 "구버전 문서"만 알고 있기 때문에 발생한다. Context7은 AI에게 최신 공식 문서를 실시간으로 주입함으로써 이 근본 원인을 해결한다.

Context7 MCP란?

Context7은 MCP(Model Context Protocol) 서버다. AI 모델이 코드를 생성할 때 최신 라이브러리 문서를 자동으로 조회하여 컨텍스트에 주입해준다.

핵심 기능은 다섯 가지다.

• resolve-library-id — 라이브러리 이름을 Context7 내부 ID로 자동 변환
• get-library-docs — 해당 라이브러리의 최신 공식 문서를 실시간 조회
• 자동 라이브러리 감지 — 프롬프트를 분석해서 관련 라이브러리를 자동으로 파악
• 문맥 기반 필터링 — 질문 의도에 맞는 문서 섹션만 선별
• 버전별 호환성 — 사용 중인 버전에 맞는 예제 코드를 제공

완전 무료 오픈소스다. 소스 코드는 GitHub에서 확인할 수 있다. 다만 실시간 문서 조회 방식이므로 인터넷 연결이 필수다.

설치 방법

Claude Desktop

Claude Desktop의 MCP 설정 파일에 다음을 추가한다.

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp@latest"]
    }
  }
}

Cursor

Settings → Tools & Integrations → New MCP Server에서 위와 동일한 JSON 설정을 추가하면 된다.

Claude Code (CLI)

CLI 환경에서는 한 줄 명령어로 설치할 수 있다.

claude mcp add --transport http context7 https://mcp.context7.com/mcp

Gemini CLI

Gemini CLI의 설정 파일(~/.gemini/settings.json)에 동일한 형식으로 추가한다.

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp@latest"]
    }
  }
}

사용 방법

사용법은 놀라울 정도로 간단해서 기존 프롬프트 끝에"use context7"만 추가하면 된다. 그러면 Context7이 자동으로 관련 라이브러리를 감지하고 최신 문서를 가져와서 AI 컨텍스트에 주입한다.

프론트엔드 예시

Next.js App Router 미들웨어

Next.js 14에서 쿠키의 JWT를 검증하고
미인증 사용자를 /login으로 리다이렉트하는
미들웨어를 만들어줘. use context7

React Query v5 + 무한 스크롤

React Query v5와 TanStack Router를 사용해서
무한 스크롤이 있는 포스트 목록 페이지를 만들어줘. use context7

Tailwind CSS 최신 기능

새로운 Dynamic Viewport 유닛(dvh)과 컨테이너 쿼리를 사용해서
모바일에서 완벽한 full-height 레이아웃을 만들어줘. use context7

백엔드 예시

FastAPI + SQLAlchemy

FastAPI에서 JWT 인증과 RBAC 권한 시스템이 포함된
사용자 관리 CRUD API를 만들어줘. use context7

MongoDB Aggregation

MongoDB에서 주문 데이터를 월별로 그룹핑하고
총액을 계산하는 aggregation 파이프라인을 작성해줘. use context7

클라우드 & DevOps 예시

Cloudflare Workers

Cloudflare Worker로 JSON API 응답을 5분간 캐시하고
CORS 헤더를 설정하는 프록시 서버를 만들어줘. use context7

Stripe Payment Intent

Stripe의 최신 Payment Intent API로 구독 결제 시스템을 구현해줘.
웹훅으로 결제 상태 동기화도 포함해서. use context7

다른 MCP와 조합하기

여러 서버를 동시에 연결할 수 있다는 게 MCP 생태계의 장점이다. Context7의 진짜 힘도 다른 MCP 서버와 조합할 때 나온다.

• Context7 + GitHub MCP — 최신 문서를 참조하면서 레포지토리 코드를 분석. "이 코드를 최신 API로 마이그레이션해줘" 같은 요청에 강력하다.
• Context7 + PostgreSQL MCP — 라이브러리 문서 + 실제 DB 스키마를 동시에 참조. ORM 코드 생성 시 실제 테이블 구조에 맞는 코드를 만들어준다.
• Context7 + Slack MCP — 개발 문서 참조 + 팀 커뮤니케이션. 기술적 질문에 대한 답변을 문서 기반으로 팀 채널에 공유할 수 있다.

실제로 써보니

직접 써보면서 느낀 점은, "use context7" 한 마디가 생각보다 큰 차이를 만든다는 것이다. 특히 빠르게 업데이트되는 라이브러리(Next.js, React Query, Tailwind 등)를 다룰 때 deprecated 코드를 받아서 삽질하는 시간이 확실히 줄었다.

다만 모든 라이브러리를 지원하지는 않고 인터넷 연결이 필수라는 점은 알아둬야 한다. 주요 라이브러리 대부분은 지원하며 미지원 라이브러리도 요청하면 추가해준다고 한다.

AI 코딩 도구를 본격적으로 쓰고 있다면 Context7은 거의 필수에 가까운 MCP라고 생각한다. 설치 1분, 사용법 "use context7" 한 줄이면 끝이니 한번 설치해보길 추천한다.

참고

• Context7 GitHub 레포지토리
• Model Context Protocol 공식 문서
• 갓대희 - Context7 MCP 설치 및 사용방법 (원본 참고 글)