arabold/docs-mcp-server

Grounded Docs MCP Server: Open-Source Alternative to Context7, Nia, and Ref.Tools

Docs MCP Server 는 무엇인가요?

Grounded Docs MCP Server 는 사용하는 코드 라이브러리나 프레임워크의 검색 가능하고 버전 지정된 문서 인덱스를 로컬에서 생성하는 오픈소스 도구입니다. 공식 사이트, GitHub 리포지토리, npm / PyPI 패키지, 로컬 폴더 또는 ZIP 아카이브에서 최신 문서를 가져와 일반 텍스트/마크다운으로 변환하고, (선택적으로) 벡터 임베딩을 저장하여 언어 모델이 필요한 정확한 문장을 검색할 수 있도록 합니다. 서버는 로컬에서 실행되며, Claude, Cline, Copilot, Gemini‑CLI 등 AI 코딩 어시스턴트가 쿼리할 수 있는 간단한 MCP(Message‑Stream‑Endpoint) API를 제공합니다.

왜 중요한가요?

허구 감소 – LLM은 추측하는 대신 실제 최신 문서에서 답변합니다.
버전 인식 – 프로젝트가 의존하는 정확한 라이브러리 버전을 인덱싱할 수 있습니다.
개인정보 보호 및 로컬 실행 – 모든 처리는 귀하의 기계에서 이루어지며, 코드나 문서는 네트워크 밖으로 나가지 않습니다.
광범위한 포맷 지원 – PDF, Office 파일, 마크다운, Jupyter 노트북, 90개 이상의 소스코드 언어가 자동으로 파싱됩니다.
기존 AI 도구와 즉시 연동 – 어떤 MCP 호환 클라이언트(Claude, Cline, VS Code 확장 등)와도 작동합니다.

핵심 기능 (README에 설명됨)

기능	설명
CLI 우선 워크플로우	`scrape`, `search`, `fetch-url` 명령어를 통해 스크립트나 에이전트가 문서를 인덱싱하고 의미적 검색을 수행하며 원본 페이지를 가져올 수 있습니다.
웹 UI	`http://localhost:6280` 에서 접근 가능하며, 브라우저를 통해 문서를 추가하고 인덱스를 확인하며 설정을 관리할 수 있습니다.
MCP 서버	AI 클라이언트가 설정 파일에서 지정할 수 있는 장시간 실행되는 SSE 엔드포인트 (`/sse`)입니다.
임베딩 지원	OpenAI, Ollama, Gemini, Azure 등과 같은 옵션 벡터 임베딩은 의미적 검색 품질을 향상시킵니다.
Docker 이미지	격리된 배포를 위한 공식 컨테이너 (`ghcr.io/arabold/docs-mcp-server:latest`)가 제공됩니다.
해시 기반 SPA 처리	`--preserve-hashes` 플래그(또는 UI 체크박스)를 통해 스크래퍼가 URL 조각을 유지하고, 필요 시 Playwright를 사용해 클라이언트 사이드 렌더링을 대체합니다.
마크다운 우선 크롤링	`Accept: text/markdown` 헤더를 전송합니다. 사이트가 직접 마크다운을 제공할 수 있으면 HTML에서 마크다운으로 변환하는 과정을 건너뜁니다.
광범위한 포맷 목록	PDF, Word/Excel/PowerPoint, OpenDocument, RTF, EPUB, Jupyter 노트북, 아카이브, HTML, 마크다운 변형, 여러 프로그래밍 언어, 설정 파일, 데이터 포맷 등.
인증 및 보안	OAuth2/OIDC 지원과 본격적인 배포를 위한 하드닝 가이드가 문서에 기재되어 있습니다.

빠른 시작 가이드 (README에서)

설치/실행 – 영구 설치 필요 없음; Node 22+ 의 npx 사용:

npx @arabold/docs-mcp-server@latest          # 서버 및 UI 시작

또는 Docker 컨테이너 실행:

docker run --rm -v docs-mcp-data:/data -v docs-mcp-config:/config \
  -p 6280:6280 ghcr.io/arabold/docs-mcp-server:latest \
  --protocol http --host 0.0.0.0 --port 6280

문서 소스 인덱싱 (CLI 예제):
```
npx @arabold/docs-mcp-server@latest scrape react https://react.dev/reference/react
```
해시 기반 SPA 문서에는 --preserve-hashes 를 추가합니다.

인덱스 검색:

npx @arabold/docs-mcp-server@latest search react "useEffect cleanup" --output yaml

AI 클라이언트 연결 – 클라이언트의 MCP 설정에 서버를 추가합니다. 예: Claude 데스크톱
```
{
  "mcpServers": {
    "docs-mcp-server": { "type": "sse", "url": "http://localhost:6280/sse" }
  }
}
```
(옵션) 임베딩 활성화 – 서버 시작 전에 OPENAI_API_KEY (또는 다른 제공자 환경 변수)를 설정하면 의미적 검색이 가능합니다.

누구에게 적합한가요?

AI 지원 코딩 도구를 개발하는 개발자.
내부 라이브러리용 개인적이고 버전 고정 지식 기반을 원하는 팀.
검색 기반 증강 생성(RAG) 파이프라인을 실험하는 연구자.
Claude, Cline, Copilot, Gemini‑CLI 등에 즉시 사용 가능한 MCP 엔드포인트가 필요한 도구 제작자.

더 많은 정보 찾기

설치 및 설정 – docs/setup/installation.md
클라이언트 연결 – docs/guides/mcp-clients.md
임베딩 모델 구성 – docs/guides/embedding-models.md
지원 포맷 목록 – docs/concepts/supported-formats.md
아키텍처 개요 – ARCHITECTURE.md
기여 가이드 – CONTRIBUTING.md

라이선스

MIT – 자유롭게 사용, 수정, 재배포 가능합니다.