Context7

최신 라이브러리 문서를 코딩 에이전트에 실시간으로 넣는 MCP 서버

npx ctx7 setup

모델이 옛 학습 데이터로 라이브러리를 잘못 쓰는 일을 막는 MCP 서버입니다. 수많은 오픈소스의 버전별 공식 문서와 예제를 실시간으로 컨텍스트에 넣어 줍니다. npx ctx7 setup 한 줄이면 Claude Code·Cursor 같은 도구에 등록까지 끝납니다.

판단

이럴 때 씁니다

모델이 옛 학습 데이터로 라이브러리를 잘못 쓰는 환각을 입력 단계에서 막고 싶을 때.
특정 버전 문서가 필요할 때. 버전을 찍어 물으면 그 버전 기준으로 답합니다.
/org/repo로 라이브러리를 직접 지정해 검색을 건너뛰고 바로 문서를 끌어오고 싶을 때.
Claude Code·Cursor 등 주요 도구에 한 줄로 자동 등록하고 싶을 때.

이럴 땐 쓰지 마세요

무료로 대량 호출하려면 한도를 확인하세요. 2026년 1월 무료 한도가 월 약 6,000건에서 1,000건 수준으로 줄었습니다.
Node.js 18 이상이 필요하고, 전역 설치 방식에 따라 제거 명령이 달라 깔끔히 안 지워질 수 있습니다.
내 코드를 보는 도구는 아닙니다. 코드베이스 탐색은 Serena 같은 도구의 몫입니다.

차별점

버전을 찍어 물어보면 그 버전 문서를 정확히 가져옵니다. Next.js 14 미들웨어를 물으면 14 기준으로 답합니다.
/org/repo 형식으로 라이브러리를 직접 지정하면 검색 단계를 건너뛰고 바로 문서를 끌어옵니다.
MCP를 붙이지 않아도 ctx7 CLI 스킬만으로 문서를 가져올 수 있습니다.
한 줄 명령으로 주요 코딩 도구 대부분에 자동 등록됩니다.

워크플로

01npx ctx7 setup --claude로 Claude Code에 Context7 MCP를 자동 설정합니다.
02코드 작업 중 라이브러리 사용법을 물을 때 "use context7"처럼 덧붙이면 공식 문서를 끌어옵니다.
03버전이 중요하면 버전을 명시해 그 버전 문서를 받습니다.
04특정 라이브러리는 /org/repo로 직접 지정해 검색 단계를 건너뜁니다.

주요 명령

명령	설명
`npx ctx7 setup --claude`	Claude Code에 Context7 MCP를 자동 설정합니다
`claude mcp add --transport http context7 https://mcp.context7.com/mcp`	원격 MCP 서버로 수동 등록합니다
`npx ctx7 remove`	설정을 제거합니다

설정

// claude_desktop_config.json
{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]
    }
  }
}

함정

설치 전에 확인하세요

Node.js 18 이상이 필요합니다. npm install -g ctx7로 전역 설치했다면 npx ctx7 remove로는 안 지워지니 npm uninstall -g ctx7을 따로 돌립니다.

직접 써본 메모

모델이 없는 API를 지어내거나 옛 버전 문법으로 답하는 일이 잦다면, 그걸 입력 단계에서 끊는 도구입니다. 버전을 찍어 물으면 그 버전 문서를 끌어오기 때문에 Next.js나 React처럼 버전마다 API가 갈리는 라이브러리에서 특히 값을 합니다. 거의 안 바뀌는 표준 라이브러리만 쓴다면 체감은 작습니다.

역할이 Serena와 정확히 갈립니다. Serena가 '내 코드'를 심볼로 읽는다면 Context7은 '바깥 라이브러리' 문서를 넣습니다. 둘을 같이 붙이면 안과 밖을 모두 보는 셈이라 부딪치지 않습니다.

다만 무료로 계속 기댈 수 있는 도구는 아닙니다. 2026년 1월 무료 한도가 월 약 6,000건에서 1,000건 수준으로 크게 줄었다는 정리가 있어, 자주 쓰는 환경이라면 한도와 유료 전환을 미리 따져 두는 게 좋습니다.

비교

모델 머릿속 지식은 학습 시점에 멈춰 있어 없는 API를 지어내기 쉽고, 웹 검색은 버전이 어긋나기 쉽습니다. Context7은 공식 문서를 버전째 끌어와 넣으니 환각과 옛 코드를 입력 단계에서 끊습니다. 같은 코드 작업을 돕는 Serena가 '내 코드'를 본다면, 이쪽은 '바깥 라이브러리'를 봅니다.

최근 변경

ctx7 0.5.6에서 Windows Defender 오탐을 줄이고 GitHub tree API 차단 시 raw SKILL.md 대체 경로와 개선된 질의 프롬프트를 추가했다.

공식 변경 내역