LLM에 정확한 라이브러리 문서를 제공하는 CLI를 만들었습니다 — MCP 서버가 필요 없습니다
Source: Dev.to
문제
Next.js 15로 개발 중에 AI 어시스턴트에게 API 라우트를 작성해 달라고 하면, AI는 Next.js 12의 Pages Router 패턴을 알려줍니다. React 문서를 프롬프트에 붙여넣어도 복사하는 시점에는 이미 오래된 버전이 되어 있습니다.
Context7은 문서를 직접 소스 레포에서 인덱싱하고 MCP 서버를 통해 제공함으로써 이 문제를 해결했습니다. Cursor, Claude Code, 기타 AI 에디터들은 환상적인 API가 아니라 실제 버전‑특정 문서를 얻기 위해 이를 사용합니다.
하지만 MCP에는 제약이 있습니다: MCP‑호환 클라이언트가 필요합니다. 터미널에서 작업하거나 스크립트를 실행하거나 로컬 LLM을 사용할 경우‑‑ 운이 없습니다.
해결책
저는 c7 를 만들었습니다 — 같은 Context7 데이터베이스에서 정보를 가져와 stdout 으로 평문을 출력하는 CLI 입니다.
c7 react hooks
c7 express middleware
c7 nextjs "app router"
서버도, 설정도, IDE 통합도 필요 없습니다. 어디에든 파이프할 수 있는 텍스트만 제공합니다.
작동 방식
CLI는 두 가지 일을 합니다:
- 라이브러리 이름을 Context7 ID 로 변환 (예:
react→/websites/react_dev) - 해당 라이브러리의 문서를 주제별로 가져옴
내부적으로는 Node.js 내장 fetch 를 사용해 Context7 v2 API에 두 번 호출합니다. 전체 프로젝트는 두 파일에 걸쳐 약 220줄이며 의존성이 전혀 없습니다.
bin/c7.js — 136 lines (CLI parsing + output formatting)
lib/api.js — 87 lines (Context7 v2 API client)
axios도, commander도, chalk도 없습니다. process.argv와 fetch만 사용합니다.
진정한 힘: 파이프
c7 은 평문을 stdout 으로 출력하기 때문에 모든 것과 조합할 수 있습니다.
LLM에 파이프
# Claude
c7 react hooks | claude "summarize the key patterns and show examples"
# Ollama (local models)
c7 express middleware | ollama run codellama "explain this middleware pattern"
# Any LLM CLI
c7 nextjs "api routes" | llm "write an API route based on these docs"
Unix 도구에 파이프
# 문서 검색
c7 nextjs "api routes" | grep "export"
# 페이지 단위로 보기
c7 prisma "schema" | less
# 클립보드 복사 (macOS)
c7 react "useEffect" | pbcopy
# 컨텍스트 파일 만들기
c7 nextjs "app router" >> context.txt
c7 react "server components" >> context.txt
스크립트에서 사용
# 코딩 에이전트를 위한 사전 로드 컨텍스트
DOCS=$(c7 nextjs "app router middleware")
claude "Build a Next.js middleware that handles auth. Use these docs:\n$DOCS"
c7 vs MCP Server
| Feature | MCP Server | c7 CLI |
|---|---|---|
| Setup | 서버 설치, MCP 클라이언트 설정, 에디터 재시작 (npx @vedanth/context7) | 설정 없이 어디서든 실행 |
| Works in | MCP‑호환 에디터 | 터미널, 스크립트, CI, 어디서든 |
| Composable | MCP 프로토콜에 제한됨 | 파이프, 리다이렉트, 서브쉘 |
| Dependencies | 여러 npm 패키지 | 없음 |
| Lines of code | ~1000+ | ~220 |
두 방식은 보완관계에 있습니다: 에디터에서는 MCP 서버를, 그 외 환경에서는 c7 을 사용하세요.
시작하기
# 설치 없이 실행
npx @vedanth/context7 react hooks
# 전역 설치
npm install -g @vedanth/context7
c7 react hooks
c7 express middleware
c7 nextjs "app router" | claude "summarize"
기본 사용에는 API 키가 필요하지 않습니다. 더 높은 호출 제한이 필요하면 Context7 대시보드에서 무료 키를 발급받으세요.
Links
- GitHub:
- npm:
- Landing page:
- Context7: