[MCP] Context7 Server

 

개념

 

왜 필요한가

AI 에게 Framework나 Library 사용법을 물으면 코드를 빠르게 얻을 수 있지만, 

생성할 때 사용하는 정보가 현재 프로젝트에서 사용하는 버전의 최신 Documentation과 항상 일치하는 것은 아님

그로 인해 아래와 같은 문제가 발생 할 수 있음

• 이전 버전의 API 사용
• Deprecated된 사용법 제안
• 현재 버전과 다른 설정 방법 제공
• 변경된 Method나 Option 사용
• 실제 Documentation과 다른 코드 생성 

 

Context7이 이 문제를 해결 할 수 있는 방법

AI가 답변하기 전에 관련 Library Documentation을 조회해서 Context에 추가

 

개념

AI가 개발 질문에 답할 때 필요한 Library / Framework Documentation을 조회하고, 

해당 정보를 AI의 Context로 제공하는 도구 

 

---

 

주요 MCP Tool

 

ex) Laravel에서 Cache::remember를 사용하는 방법 알려줘. 

1. "Laravel" 확인
        ↓
2. resolve-library-id
        ↓
3. /laravel/docs
        ↓
4. query-docs
        ↓
5. Cache::remember 관련 Documentation 조회
        ↓
6. 관련 내용 반환
        ↓
7. LLM이 이를 참고해 답변 생성

 

resolve-library-id

Library 이름을 Context7 Library ID로 변환

query-docs

Library ID를 기준으로 관련 Documentation 조회

 

---

 

MCP Server 설정방법

 

Remote MCP Server 방식

Remote MCP Server 연결

{
  "mcpServers": {
    "context7": {
      "url": "https://mcp.context7.com/mcp"
    }
  }
}

※ 단, 설정 형식은 MCP Client마다 다름

 

API Key 사용 

수동 설정할 때 API Key를 인증 Header에 전달하는 방식

MCP Server 주소
+
인증 정보

 

API Key를 사용하면 사용량 제한이나 인증이 필요한 상황에서 사용할 수 있음. 

 

Local 방식

Remote Server에 직접 연결하는 대신, 자신의 환경에서 Context7 MCP Package를 실행하도록 MCP Client설정 가능

 

대표적인 설정

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

 

CLI 설정

npx ctx7 setup

 

npx ctx7 setup
   ↓
사용할 Client 선택
   ↓
인증
   ↓
MCP 설정 생성

 

설정 파일 위치나 JSON 구조를 직접 작성하기 번거로운 경우 사용 가능.

 

---

 

주요 사용 방법

 

Context7을 연결한 뒤에는 별도의 복잡한 명령어를 외우기보다, 

평소 개발 질문에 Context7를 사용하도록 지시하는 방식으로 활용하면 된다. 

 

Context7 공식 문서에서도 Prompt에 use context7을 추가하는 방식을 기본 사용 예시로 안내하고 있음

 

사용 예시

구분	설명(예시)
Library 사용법 확인	ex) Laravel에서 Cache::remember 사용 방법 알려줘. use context7
특정 Version의 사용법 확인	ex) Next.js 14에서 Middleware를 설정하는 방법 알려줘. use context7
처음 사용하는 Library 확인	ex) Supabase에서 Email/Password 회원가입을 구현하는 방법 알려줘. use context7
Configuration 확인	Framework나 Library의 설정 방법 확인 ex) Laravel에서 Redis를 Cache Store로 설정하는 방법 알려줘. use context7
특정 API 사용법 확인	ex) Laravel Http Client의 retry() 사용 방법과 Parameter를 알려줘. use context7
코드 생성과 함께 사용	ex) Next.js에서 JWT를 확인하고 인증되지 않은 사용자를 /login으로 이동시키는 Middleware를 작성해줘. use context7

 

 

더 좋은 질문을 만드는 방법

다음 정보를 포함하는 편이 좋음

정보	예
Library	Laravel
Version	12
기능	Rate Limiting
상황	로그인 API
원하는 결과	사용자별 제한 구현