context7 MCP Server — 최신 코드 문서 제공 (upstash/context7)

upstash/context7 GitHub 저장소의 주요 내용과 설치법, 특징을 요약 번역한 문서입니다.

---

주요 특징

• 최신 코드 예시 제공: LLM(대형 언어 모델)이 오래된 정보나 잘못된 API 예시를 사용하는 문제를 해결합니다.
• 다양한 에디터 및 플랫폼 지원:
  • VS Code, Zed, Claude Code, Claude Desktop, BoltAI 등 다양한 환경에서 설치 및 연동 가능
  • Docker, Windows, macOS, Linux 등 다양한 운영체제 지원

---

설치 및 사용법

VS Code에서 설치

settings.json에 다음과 같이 MCP 서버를 등록합니다.

{
  "servers": {
    "Context7": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"]
    }
  }
}

Zed에서 설치

settings.json에 다음과 같이 추가합니다.

{
  "context_servers": {
    "Context7": {
      "command": {
        "path": "npx",
        "args": ["-y", "@upstash/context7-mcp"]
      },
      "settings": {}
    }
  }
}

Claude Code에서 설치

claude mcp add context7 -- npx -y @upstash/context7-mcp

Docker로 실행

1. Dockerfile 생성 후 아래와 같이 작성:

    FROM node:18-alpine
    WORKDIR /app
    RUN npm install -g @upstash/context7-mcp
    CMD ["context7-mcp"]

2. 이미지 빌드 및 실행:

    docker build -t context7-mcp .
    docker run -i --rm context7-mcp

환경 변수

• DEFAULT_MINIMUM_TOKENS: 문서 검색 시 최소 토큰 수 설정 (기본값: 10000)

---

제공 도구

• resolve-library-id: 일반 라이브러리명을 Context7 호환 ID로 변환
• get-library-docs: 라이브러리 ID로 문서 검색 (특정 주제, 토큰 수 지정 가능)

---

문제 해결

• ERR_MODULE_NOT_FOUND: npx 대신 bunx 사용 권장
• ESM 모듈 문제: --experimental-vm-modules 플래그 사용
• TLS 문제: --experimental-fetch 플래그 사용

---

라이선스

• MIT License

---

공식 문서 및 링크

• GitHub 저장소
• 공식 웹사이트

---

이 문서는 최신 코드 문서 자동화 및 AI 코드 도우미 환경에서 Context7을 활용하고자 하는 개발자를 위한 안내입니다. 자세한 설치법, 예시, 문제 해결법 등은 공식 GitHub 저장소의 README를 참고하세요.