Context7 Key Rotator MCP

Context7 V2용 작고 독립적인 원격 HTTP Model Context Protocol 서버입니다. 정확히 두 가지 도구를 노출합니다:

• resolve-library-id(libraryName, query)

• query-docs(libraryId, query)

각 일반 요청은 CONTEXT7_API_KEYS에 있는 두 키를 번갈아 사용합니다. Context7가 선택 키(401, 403 또는 429)를 차단하면 서버는 다른 키로 요청을 한 번 재시도합니다. 두 키가 모두 차단되면 도구 호출은 MCP 오류를 반환합니다.

서버는 무상태(stateless)입니다. OAuth, CLI 어댑터, 영구 키 상태, 쿨다운, 점수 계산, 프록시, 세션 저장소가 없습니다. 세션 저장소가 없습니다.

로컬 실행

CONTEXT7_API_KEYS에는 쉼표로 구분된 Context7 API 키가 정확히 두 개 들어 있어야 합니다. 이 값은 시크릿 매니저에 보관하고, 커밋된 .env 파일에는 넣지 마세요.

doppler run -p ai-automation -c dev -- npm start

서버는 PORT(기본값 3000)에서 POST /mcp 요청을 수신 대기합니다. 호스팅 환경이 네트워크 노출, TLS, 클라이언트 등록을 담당합니다.

Related MCP server: Context7 MCP Python Server

개발

npm install
npm test
npm run build

테스트는 Context7 V2를 목(mock)으로 처리하며, 정상 교대 동작, 차단 응답 후 다른 키로 재시도하는 동작, 두 키가 모두 차단된 경우의 실패, 그리고 네이티브 호환 결과 포맷터를 검증합니다.