Context7 · DeepWiki 등 — 라이브러리 문서를 LLM 에 붙이기

LLM 의 학습 데이터 시점이 늘 최신과 어긋납니다. 라이브러리 문서·API 명세는 자주 바뀌고, 모델은 옛 정보를 자신감 있게 답합니다. 문서를 LLM 친화 형식으로 노출하는 MCP 서버·서비스가 그 자리에 등장했습니다.

1. 도구들에 대한 이야기

Context7 — Upstash 가 운영하는 라이브러리 문서 제공 서비스. 사이트는 context7.com, 코드는 github.com/upstash/context7. 각 라이브러리의 공식 문서·README·예제를 LLM 친화 형식 (마크다운) 으로 미리 정리해 두고 MCP 서버 또는 HTTP API 로 노출.

자주 보이는 사용 패턴:

프롬프트 끝에 "use context7" 한 줄을 더한다.

이 문구가 들어가면 MCP 클라이언트가 Context7 서버에 라이브러리 ID 를 묻고 받은 문서 일부를 컨텍스트에 넣는 흐름.

DeepWiki — Devin AI (Cognition) 가 운영하는 GitHub 저장소 문서화 서비스. 임의 GitHub 저장소를 분석해 자동 생성된 위키와 검색을 제공하고, MCP 서버 형태로도 노출.

Ref — 다양한 공식 문서를 LLM 친화 형식으로 모아 노출하는 서비스. MCP 서버로 제공.

devdocs.io — Thibaut Courouble 등이 만든 오픈소스 다중 문서 뷰어 (2013~). MDN · Python · Ruby · Node · Rust 등 수십 종의 공식 문서를 통합 검색. 직접적 LLM 통합은 아니지만 문서 통합 검색의 원형.

llms.txt — Jeremy Howard 등이 2024 년 제안한 단순 규약. 사이트 루트의 /llms.txt 또는 /llms-full.txt 에 마크다운으로 문서 인덱스·요약을 두어 LLM 이 사이트를 빠르게 이해하게 한다는 아이디어.

# 사이트 이름
> 한 줄 요약

## Docs
- [Getting Started](https://example.com/docs/start.md): 30 초 시작.
- [API Reference](https://example.com/docs/api.md): 전체 API.

2. Context7 의 흐름

라이브러리 식별자 (/vendor/library 또는 라이브러리 이름) 로 조회.
서버가 해당 라이브러리의 정리된 문서 토픽 목록 반환.
토픽별 문서를 가져와 모델 컨텍스트에 주입.

라이브러리는 등록된 풀에서 가져오는 모양이라 등록 여부에 따라 가용성이 달라집니다.

3. MCP 등록 형식

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

원격 HTTP 트랜스포트로도 등록 가능. 인증·요청 한도는 운영자 문서.

4. llms.txt 와의 관계

사이트가 /llms.txt 를 두면 도구·서비스가 그 인덱스를 따라가며 컨텍스트 주입을 만듭니다.
Context7 같은 서비스는 사이트의 /llms.txt 가 있든 없든 자체 정리한 문서를 제공. 둘은 보완 관계.
llms.txt 의 채택률이 늘면 별도 중개 서비스 의존이 줄어들 가능성.

5. 다른 길들

자리	도구 / 서비스
라이브러리 문서 정리·노출	Context7 · Ref · GitMCP.
임의 저장소 위키화	DeepWiki.
다중 공식 문서 통합 검색	devdocs.io.
사이트 측 자기 노출	llms.txt · llms-full.txt.
자체 문서 인덱싱	RAG 직접 구축 (pgvector · LlamaIndex).
구조화된 코드 검색	Sourcegraph · GitHub code search.

선택은 다음에 달려 있습니다:

자료가 정적인지 자주 바뀌는지.
인증·정책 통제 필요성.
데이터 외부 송신 가능 여부.
응답 지연 허용 범위.

6. 코딩 보조와 결합

LLM 코딩 보조 도구에 Context7 류 서버를 등록하면 도움이 되는 자리:

빠르게 변하는 라이브러리 (TypeScript SDK) 의 시그니처 확인.
새 메이저 버전의 변경점 인식.
옛 모델이 아는 API 와 실제 API 의 어긋남 보정.

7. 자기 라이브러리 노출

자기 라이브러리·SaaS 를 LLM 친화로 만드는 가닥:

사이트 루트에 /llms.txt · /llms-full.txt 추가.
마크다운 문서를 정적 호스팅.
API 레퍼런스를 OpenAPI 로도 함께 노출.
Context7 등록을 시도 (가능한 경우).

8. 토큰 한도와 발췌 전략

라이브러리 문서를 통째로 컨텍스트에 넣으면 토큰이 빠르게 차오릅니다. 도구는 보통 토픽 단위로 잘라서 전달. 호출자가 명시적 토픽을 지정하거나, 기본값을 두는 모양이 흔합니다.

9. 자주 걸리는 자리

버전 표류 — 문서를 업데이트하지 않은 사이에 새 버전이 출시되면 옛 정보가 그대로 노출. 갱신 시점 확인.

소수 라이브러리 미등록 — 큰 생태계는 잘 다뤄지지만 한국어·소수 라이브러리는 등록되지 않은 경우.

신뢰 경계 — 외부 서버에서 받은 문서 안에 프롬프트 인젝션이 숨어 있을 수 있습니다. 호스트 측 신뢰 경계 설계.

데이터 송신 — 일부 서비스는 사용자 쿼리를 학습 데이터로 사용할 수 있습니다. 정책 확인.

컨텍스트 폭주 — "use context7" 한 줄에 너무 큰 묶음이 들어와 다른 컨텍스트를 밀어낼 수 있음. 토픽 명시.

링크 깨짐 — llms.txt 의 링크가 깨지면 도구가 잘못된 페이지를 가져갑니다. 상대경로·절대경로 일관성.

하고픈 말

LLM 학습 시점과 라이브러리의 실제 시점이 늘 어긋나는 문제는 Context7 · llms.txt · 자체 RAG 같은 도구로 보완됩니다. 자기 라이브러리·SaaS 를 노출할 자리에서는 /llms.txt 한 줄이 빠른 출발점이 됩니다.

mcp-figma
google-adk

Context7 · Context7 GitHub · DeepWiki · devdocs.io · llms.txt 제안 · Anthropic MCP · Awesome MCP Servers 를 참고합니다.

Context7 · DeepWiki — 라이브러리 문서를 LLM 에 붙이기