날먹이면서 딸깍 🙏 context7 MCP로 AI 코드 에디터에 실시간 개발 정보 주입하기

소개

AI 코드 에디터를 쓸 때 필요한 정보를 매번 검색해서 Curor나 Winsurf 같은 AI 코드 에디터에 추가하는 게 번거롭지 않으셨나요? 🤯 저는 그랬습니다.

그러다 context7이라는 도구를 알게 됐고, 그 위에 있는 MCP 기능까지 활용하게 되면서 완전히 새로운 작업 흐름을 갖게 되었어요.

지금부터 어떻게 이 도구들을 활용해서, 단순한 프롬프트 한 줄로 필요한 정보를 AI에게 전달했는지 공유드릴게요 🙌

진행 방법

기존 방식 vs context7

  • 기존: 필요한 내용을 검색 → 복사-붙여넣기 / 해당 페이지 다운로드 → 코드 에디터에 추가

  • context7: 프롬프트에 use context7만 추가하면 최신 문서 자동 통합 (Context7을 사용해서)

context7이 뭔가요?

  • LLM과 AI 코드 에디터용 최신 개발 문서 검색/요약 도구입니다.

  • 특정 라이브러리의 대한 최신 문서의 내용을 검색해서 토큰 범위 내에서 추출 후 제공 🎯

Context7 - Up-to-date documentation for LLMs and AI code editors

에이전트 및 개발자를위한 즉각적인 LM 컨텍스트

핵심 도구: Context7 MCP

GitHub - upstash/context7: Context7 MCP Server

Upshash Conttext 7 -Upshash Conttext 7 -Upshash Conttext 7 -Upsh

주요 기능

  • 최신 버전의 라이브러리 문서를 직접 소스에서 가져와서 프롬프트에 자동 삽입

  • "use context7" 키워드만 프롬프트에 넣으면 관련 문서를 알아서 붙여줌

설치 요건

  • Node.js v18 이상 필요

  • 사용 가능한 MCP 호스트:

    • Cursor

    • Windsurf

    • Claude Desktop 등

지원되는 MCP 명령어들

  • resolve-library-id: 일반 라이브러리 이름 → context7 호환 ID로 변환

  • get-library-docs: 해당 ID로부터 문서 가져오기

    • 옵션: topic, tokens

Windsurf 설정 예시

  1. Windsurf → Casecade → MCP Servers → Configure

  2. 설정 예시 👇

    캐스케이드의 쓰기 모드의 스크린 샷
{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp@latest"]
    }
  }
}

프롬프트 예시

context7을 사용해서 pandas 라이브러리에 대해서 검색한 후에 그걸 기반으로 간단한 예제 파이썬 코드 만들어줘.
context7을 사용해서 파이썬 개발환경인 uv에 대해서 검색한 후 그걸 바탕으로 현재 프로젝트의 파이썬 개발환경 셋팅해줘.
context7을 사용해서 fastmcp 에 대해서 검색하고 덧셈과 뺄셈을 하는 간단한 tool을 지원하는 mcp 서버 `@mcp.py`에 만들어줘.

결과와 배운 점

✅ 실제로 해보니…

  • 내가 모르는 라이브러리도 바로 사용 가능

  • 더 이상 수동 검색/복붙할 필요 없음

  • 문서가 자동 정제돼서 토큰 낭비 없음 → 필요 시 토큰 제한 가능 (tokens)

👉 이 게시글도 읽어보세요