Context7를 처음 알게 된 건, Cursor에서 Next.js middleware를 짜다 Claude가 일 년 전 next-auth 사용법을 계속 끼워 넣길래였다. 에러를 뒤져 보니 API는 이미 바뀐 지 오래.
프롬프트 맨 끝에 use context7 세 글자만 붙여 봤다. 같은 요청인데 이번엔 돌아온 코드가 v2.x 현행 버전과 딱 맞았다. 차이는 한눈에 보일 정도였다.
Context7는 GitHub의 upstash/context7 저장소가 하는 일이다. 이 글 작성 기준 61,126 Stars로 MCP 프로토콜 Server 범주에서 상위권에 든다. 하는 일은 단순하다. 라이브러리의 최신 문서와 예제 코드를 실시간으로 가져와 LLM 프롬프트에 넣음으로써, AI가 "학습 시점에 기억해 둔 스냅샷"에 의존해 코드를 짜지 않도록 만드는 것이다.
해결하려는 문제
LLM 학습 데이터에는 마감일이 있다. 라이브러리가 업그레이드되고 API가 바뀌면, 모델은 존재하지도 않는 함수를 자신만만하게 만들어 내기 시작한다. 흔히 말하는 "환각"이다. Next.js에서 middleware를 어떻게 짜냐고 물으면, 이미 deprecated된写法를 콕 집어 가르쳐 주면서 태연한 얼굴을 유지한다.
Context7의 해법은 프롬프트 단계에서 버전이 표기된 문서와 소스 예시를 컨텍스트에 주입하는 것이다. LLM이 "생각"을 시작하기 전에 현재 시점의 진짜 문서를 바로 코앞에 들이밀어 버리는 셈이다. 덕분에 Cursor나 Claude Code가 만들어 내는 코드는 기본적으로 현행 버전과 맞게 나온다.
프런트엔드, Serverless, 데이터베이스처럼 업데이트 주기가 짧은 스택일수록 그 격차가 두드러진다.
사용 방법
세 단계면 충분하다.
첫째, CLI 설치. Context7는 ctx7라는 커맨드라인 도구를 제공하며, 초기화하면 OAuth 인증이 시작되고 MCP Server 모드와 Skills 모드 중 하나를 고를 수 있다.
npx ctx7 setup
둘째, MCP Server 설치. Context7는 동시에 @upstash/context7-mcp라는 npm 패키지도 배포한다. MCP 카테고리에서 NPM 다운로드 수가 꾸준히 상위 셋 안에 든다. 이 패키지는 두 가지 표준 tool을 노출한다. resolve-library-id와 get-library-docs.
설정은 간단하다. Cursor의 ~/.cursor/mcp.json 또는 Claude Desktop의 claude_desktop_config.json에 다음을 넣으면 된다.
{
"mcpServers": {
"context7": {
"url": "https://mcp.context7.com/mcp",
"headers": {
"CONTENT_TYPE": "application/json",
"CONTEXT7_API_KEY": "<your-api-key>"
}
}
}
}
API key는 context7.com/dashboard에서 가입하면 무료 티어를 바로 받을 수 있다.
셋째, 프롬프트에 한 줄 추가. Cursor 사용자가 제일 손쉬운 방법은 프롬프트 맨 끝에 use context7을 그대로 붙이는 것이다.
Create a Next.js middleware that checks for a valid JWT in cookies
and redirects unauthenticated users to `/login`. use context7
MCP tool을 명시적으로 호출할 수도 있다. 인자는 다음과 같은 형태다.
tool: get-library-docs
args: { libraryName: "nextjs", topic: "middleware jwt" }
반환되는 결과는 버전이 함께 표기된 문서 스니펫이며, LLM의 context에 자동으로 주입된다.
현재 지원되는 클라이언트는 Cursor, Claude Code, Cline, Windsurf, OpenCode로, 주요 Agent IDE를 거의 다 커버한다. README는 커뮤니티에 의해 16개 언어로 번역됐고, 간체 중국어, 번체 중국어, 일본어, 한국어도 포함돼 있다. 이 부분은 한국어 개발자에게 작은加分 점이다.
작동 원리
핵심 파이프라인은 네 단계다. 크롤링 → 파싱 → 버전별 인덱싱 → 라이브러리 ID 기준 프롬프트 주입.
Context7는 백그라운드에서 npm, PyPI, Go 등 주요 생태계의 라이브러리 저장소를 계속 크롤링해 README, 소스 주석, 공식 문서 사이트를 수집한 뒤, /library/<id> 단위로 버전별 인덱스를 만든다. get-library-docs를 호출하면 전체 문서가 아니라 topic과 관련된 슬라이스만 돌려주기 때문에, 토큰 사용량을 최대한 줄인다.
Upstash가 이 일을 감당할 수 있는 이유는 간단하다. Upstash, 즉 Serverless Redis 업체가 직접 유지보수하기 때문이다. 문서 조회처럼 고동시, 저지연, key 기반 접근이 잦은 시나리오는 Redis의 주특기다. 인프라를 그대로 재활용할 수 있다는 점이, Context7가同类 프로젝트보다 빠른 근본적인 이유다.
MCP Server 계층은 "문서 조회"를 표준 tool로 캡슐화한다. 위에 나열한 클라이언트는 물론이고, 이론적으로는 어떤 MCP host든 호출 가능하다. MCP 프로토콜이 실제로落地한 하나의标杆 사례라고 할 수 있다.
2장점과 한계
장점:
- MCP落地의标杆 프로젝트 중 하나로, MCP가 실제로 어떻게 작동하는지 이해하려면 이것만 봐도 충분하다
- 설정이 거의 없다.
use context7세 글자면 끝, 진입 장벽이 극도로 낮다 - 소수 라이브러리 지원이 빠르다. npm, PyPI, Go에 인덱스만 잡혀 있으면 거의 당일 조회가 가능하다
- 다국어 README를 지원해 한국어 사용자도 읽기 편하다
한계:
- 핵심 동작이 네트워크 요청에 의존한다. 오프라인, 사내망, 보안 환경에서는 아예 동작하지 않는다
- 무료 티어에는 rate limit이 있다. 대규모 프로젝트, 고빈도 호출에서는 벽에 부딪힐 수 있어 Pro 티어로의 업그레이드가 필요하다
- 문서 품질은 상위 저장소 자체에 달려 있다. 라이브러리 작성자의 README가 엉망이면 Context7도 엉망 버전만 돌려줄 수밖에 없다
- 한국어 문서는 주로 커뮤니티 번역에 의존해 품질 편차가 크다
직접 써 봤다
Cursor + use context7 조합으로 Claude에게 Supabase의 auth 가입 로직을 짜게 해 봤다. 돌아온 import 경로와 함수 시그니처는 Supabase JS Client v2.x의 현행 버전과 정확히 맞았다.
같은 프롬프트에서 use context7만 빼면, Claude는 여전히 일 년 전 v1.x API를 쓰고 있었다. 이미废弃된 supabase.auth.api 같은 네임스페이스까지 그대로 꺼내 들었다.
이 차이는 "조금 더 나은" 수준이 아니라 "돌아가냐 마냐"의 차이다.
이런 사람에게 추천
써야 할 사람:
- Cursor, Claude Code로 Next.js, Cloudflare, Supabase처럼 업데이트가 빠른 스택을 다루는 경우
- MCP 프로토콜이 실제로 어떤 모양이고 어떻게落地되는지 파악하고 싶은 경우
- AI가 만들어 내는 "가짜 API"에 자주 골탕먹는 개발자
쓰지 않아도 될 사람:
- 완전 오프라인, 사내망, 보안 환경 — 인터넷이 안 되는 환경에서는 불가능하다
- 응답 지연에 극도로 민감한 시나리오 — 네트워크 왕복이 한 번 더 늘면 지연이 눈에 띄게 증가한다
- 이미 사내 RAG + 문서 검색 중대를 구축한 조직 — 내부 지식 베이스에 직접 붙이는 쪽이 더 효율적일 수 있다
편집자의 생각
Context7가 진짜 흥미로운 지점은 기술 자체가 얼마나 화려한가가 아니라, MCP라는 길이 먹힌다는 사실을 입증했다는 점이다.
문서, 데이터베이스, 브라우저 자동화 같은 것들을统一的 프로토콜로 tool로 노출하면, LLM 클라이언트가 도구마다 따로 어댑터를 맞출 필요가 없어진다. 이것이 MCP 프로토콜의 핵심 이상이다. Context7는 이 일을 "개발자가 가장 아파하는 지점"인 "코드 환각"에서 실제로 증명해 냈고, 61k Star는 개발자들이 "환각 줄이기"에 시간을 들이거나 비용을 낼 의향이 있다는 사실을 보여준다.
다만 해자(moat)는 얕다.
내 판단은 이렇다. 이런 "프롬프트급 중간층"은 다음 인프라 표준의 일부가 될 가능성이 높다. 마치 예전에 ESLint가 에디터에 박혔던 것처럼, 서드파티 도구로 시작해 결국 IDE에 네이티브로 흡수되는 경로를 밟을 것이다. Cursor, Claude Code, 앞으로 등장할 GPT-5 Codex 류의 도구는迟早 자체적으로 "문서 검색" 단계를 내장하게 될 것이고, 더 이상 외장 도구가 필요 없어지는 시점이 올 수 있다.
선발 이점은 Upstash에 있고, 사업화가 되느냐는 팀 플랜과 Pro 티어의 전환율에 달렸다. Upstash가 Context7에서 과금 사용자를 키워 낼 수 있다면, 그저 Redis 회사가 아니라 차세대 "AI 개발자 인프라" 플레이어로 자리 잡을 수 있다. 반면 전환율이 낮다면, 이 프로젝트는 결국 대형 모델 IDE의 기본 기능 안으로 흡수될 가능성이 더 크다.
아직 불확실한 지점은 남았다. Context7의 "라이브러리 ID 기준 주입" 방식은 초대형 monorepo나 사내용 private 라이브러리에 대한 커버리지가 아직 약하다. 어떤 회사의 코드베이스가 주로 private SDK로 구성돼 있다면 이 도구가 해 줄 수 있는 일은 제한적이다. 이 빈 공간을 앞으로 어떻게 메울지가 주시할 만한 방향이다.