Deepwiki MCP 서버

이것은 비공식 Deepwiki MCP 서버 입니다.

MCP를 통해 Deepwiki URL을 가져와서 모든 관련 페이지를 크롤링하고 이를 마크다운으로 변환한 다음, 페이지별로 하나의 문서나 목록을 반환합니다.

특징

🔒 도메인 안전 : deepwiki.com의 URL만 처리합니다.
🧹 HTML 정리 : 헤더, 푸터, 탐색, 스크립트 및 광고를 제거합니다.
🔗 링크 재작성 : 마크다운에서 작동하도록 링크를 조정합니다.
📄 다양한 출력 형식 : 하나의 문서 또는 구조화된 페이지를 가져옵니다.
🚀 성능 : 조정 가능한 동시성 및 깊이를 갖춘 빠른 크롤링

용법

사용할 수 있는 프롬프트:

지엑스피1

전체 문서 가져오기(기본값)

use deepwiki https://deepwiki.com/shadcn-ui/ui
use deepwiki multiple pages https://deepwiki.com/shadcn-ui/ui

단일 페이지

use deepwiki fetch single page https://deepwiki.com/tailwindlabs/tailwindcss/2.2-theme-system

단축형으로 받으세요

use deepwiki fetch tailwindlabs/tailwindcss

커서

이것을 .cursor/mcp.json 파일에 추가하세요.

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

MCP 도구 통합

이 패키지는 MCP 호환 클라이언트와 함께 사용할 수 있는 deepwiki_fetch 라는 도구를 등록합니다.

{
  "action": "deepwiki_fetch",
  "params": {
    "url": "https://deepwiki.com/user/repo",
    "mode": "aggregate",
    "maxDepth": "1"
  }
}

매개변수

url (필수): Deepwiki 저장소의 시작 URL
mode (선택 사항): 단일 마크다운 문서의 경우 "집계"(기본값) 또는 구조화된 페이지 데이터의 경우 "페이지" 출력 모드
maxDepth (선택 사항): 크롤링할 페이지의 최대 깊이(기본값: 10)

응답 형식

성공 응답(집계 모드)

{
  "status": "ok",
  "data": "# Page Title\n\nPage content...\n\n---\n\n# Another Page\n\nMore content...",
  "totalPages": 5,
  "totalBytes": 25000,
  "elapsedMs": 1200
}

성공 응답(페이지 모드)

{
  "status": "ok",
  "data": [
    {
      "path": "index",
      "markdown": "# Home Page\n\nWelcome to the repository."
    },
    {
      "path": "section/page1",
      "markdown": "# First Page\n\nThis is the first page content."
    }
  ],
  "totalPages": 2,
  "totalBytes": 12000,
  "elapsedMs": 800
}

오류 응답

{
  "status": "error",
  "code": "DOMAIN_NOT_ALLOWED",
  "message": "Only deepwiki.com domains are allowed"
}

부분적 성공 응답

{
  "status": "partial",
  "data": "# Page Title\n\nPage content...",
  "errors": [
    {
      "url": "https://deepwiki.com/user/repo/page2",
      "reason": "HTTP error: 404"
    }
  ],
  "totalPages": 1,
  "totalBytes": 5000,
  "elapsedMs": 950
}

진행 이벤트

이 도구를 사용하면 크롤링 중에 진행률 이벤트를 받게 됩니다.

Fetched https://deepwiki.com/user/repo: 12500 bytes in 450ms (status: 200)
Fetched https://deepwiki.com/user/repo/page1: 8750 bytes in 320ms (status: 200)
Fetched https://deepwiki.com/user/repo/page2: 6200 bytes in 280ms (status: 200)

지역 개발 - 설치

지역 사용

{
  "mcpServers": {
    "mcp-deepwiki": {
      "command": "node",
      "args": ["./bin/cli.mjs"]
    }
  }
}

출처에서

# Clone the repository
git clone https://github.com/regenrek/mcp-deepwiki.git
cd mcp-deepwiki

# Install dependencies
npm install

# Build the package
npm run build

직접 API 호출

HTTP 전송의 경우 직접 API 호출을 할 수 있습니다.

curl -X POST http://localhost:3000/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "id": "req-1",
    "action": "deepwiki_fetch",
    "params": {
      "url": "https://deepwiki.com/user/repo",
      "mode": "aggregate"
    }
  }'

구성

환경 변수

DEEPWIKI_MAX_CONCURRENCY : 최대 동시 요청 수(기본값: 5)
DEEPWIKI_REQUEST_TIMEOUT : 요청 시간 초과(밀리초) (기본값: 30000)
DEEPWIKI_MAX_RETRIES : 실패한 요청에 대한 최대 재시도 횟수(기본값: 3)
DEEPWIKI_RETRY_DELAY : 재시도 백오프에 대한 기본 지연 시간(밀리초)(기본값: 250)

이를 구성하려면 프로젝트 루트에 .env 파일을 만듭니다.

DEEPWIKI_MAX_CONCURRENCY=10
DEEPWIKI_REQUEST_TIMEOUT=60000
DEEPWIKI_MAX_RETRIES=5
DEEPWIKI_RETRY_DELAY=500

Docker 배포(테스트되지 않음)

Docker 이미지를 빌드하고 실행합니다.

# Build the image
docker build -t mcp-deepwiki .

# Run with stdio transport (for development)
docker run -it --rm mcp-deepwiki

# Run with HTTP transport (for production)
docker run -d -p 3000:3000 mcp-deepwiki --http --port 3000

# Run with environment variables
docker run -d -p 3000:3000 \
  -e DEEPWIKI_MAX_CONCURRENCY=10 \
  -e DEEPWIKI_REQUEST_TIMEOUT=60000 \
  mcp-deepwiki --http --port 3000

개발

# Install dependencies
pnpm install

# Run in development mode with stdio
pnpm run dev-stdio

# Run tests
pnpm test

# Run linter
pnpm run lint

# Build the package
pnpm run build

문제 해결

일반적인 문제

권한 거부 : CLI를 실행할 때 EACCES 오류가 발생하면 바이너리를 실행 가능하게 만들어야 합니다.
chmod +x ./node_modules/.bin/mcp-deepwiki
연결 거부 : 포트가 사용 가능하고 방화벽으로 차단되지 않았는지 확인하세요.
# Check if port is in use lsof -i :3000
시간 초과 오류 : 대규모 저장소의 경우 시간 초과 및 동시성을 늘리는 것을 고려하세요.
DEEPWIKI_REQUEST_TIMEOUT=60000 DEEPWIKI_MAX_CONCURRENCY=10 npx mcp-deepwiki

기여하다

기여를 환영합니다! 자세한 내용은 CONTRIBUTING.md를 참조하세요.

특허

MIT

모래밭

X/트위터: @kregenrek
블루스카이: @kevinkern.dev

행동

커서 AI 배우기: 궁극의 커서 코스
AI를 활용한 소프트웨어 구축 방법 배우기: instructa.ai

다른 프로젝트도 확인해 보세요:

AI 프롬프트 - Cursor AI, Cline, Windsurf 및 Github Copilot을 위한 큐레이션된 AI 프롬프트
codefetch - 간단한 터미널 명령 하나로 코드를 LLM용 Markdown으로 변환
AI 언어 모델에 대한 자세한 정보를 제공하는 CLI 도구 로 , 개발자가 자신의 필요에 맞는 올바른 모델을 선택하는 데 도움이 됩니다.# tool-starter

Deepwiki MCP Server

Integrations