딥뷰 MCP

DeepView MCP는 Cursor 및 Windsurf와 같은 IDE가 Gemini의 광범위한 컨텍스트 창을 사용하여 대규모 코드베이스를 분석할 수 있도록 하는 모델 컨텍스트 프로토콜 서버입니다.

특징

• 단일 텍스트 파일에서 전체 코드베이스를 로드합니다(예: repomix와 같은 도구로 생성).

• Gemini의 큰 컨텍스트 창을 사용하여 코드베이스 쿼리

• Cursor 및 Windsurf와 같은 MCP 프로토콜을 지원하는 IDE에 연결

• 명령줄 인수를 통한 구성 가능한 Gemini 모델 선택

Related MCP server: @lex-tools/codebase-context-dumper

필수 조건

• 파이썬 3.13+

• Google AI Studio 의 Gemini API 키

설치

Smithery를 통해 설치

Smithery를 통해 Claude Desktop에 DeepView를 자동으로 설치하는 방법:

지엑스피1

pip 사용하기

pip install deepview-mcp

용법

서버 시작

참고: 서버를 수동으로 시작할 필요는 없습니다. 이러한 매개변수는 IDE의 MCP 설정에서 구성됩니다(아래 참조).

# Basic usage with default settings
deepview-mcp [path/to/codebase.txt]

# Specify a different Gemini model
deepview-mcp [path/to/codebase.txt] --model gemini-2.0-pro

# Change log level
deepview-mcp [path/to/codebase.txt] --log-level DEBUG

코드베이스 파일 매개변수는 선택 사항입니다. 지정하지 않으면 쿼리를 실행할 때 지정해야 합니다.

명령줄 옵션

• --model MODEL : 사용할 Gemini 모델을 지정합니다(기본값: gemini-2.0-flash-lite)

• --log-level {DEBUG,INFO,WARNING,ERROR,CRITICAL} : 로깅 수준을 설정합니다(기본값: INFO)

IDE(Cursor/Windsurf/...)와 함께 사용

1. IDE 설정 열기

2. MCP 구성으로 이동

3. 다음 구성으로 새로운 MCP 서버를 추가합니다.

   {
     "mcpServers": {
       "deepview": {
         "command": "/path/to/deepview-mcp",
         "args": [],
         "env": {
           "GEMINI_API_KEY": "your_gemini_api_key"
         }
       }
     }
   }

코드베이스 파일 설정은 선택 사항입니다. 동일한 코드베이스를 사용하는 경우 다음 구성을 사용하여 기본 코드베이스 파일을 설정할 수 있습니다.

{
   "mcpServers": {
     "deepview": {
       "command": "/path/to/deepview-mcp",
       "args": ["/path/to/codebase.txt"],
       "env": {
         "GEMINI_API_KEY": "your_gemini_api_key"
       }
     }
   }
 }

사용할 Gemini 버전을 지정하는 방법은 다음과 같습니다.

{
   "mcpServers": {
     "deepview": {
       "command": "/path/to/deepview-mcp",
       "args": ["--model", "gemini-2.5-pro-exp-03-25"],
       "env": {
         "GEMINI_API_KEY": "your_gemini_api_key"
       }
     }
   }
}

4. MCP 서버 구성 다시 로드

사용 가능한 도구

서버는 하나의 도구를 제공합니다.

1. deepview : 코드베이스에 대한 질문하기

   • 필수 매개변수: question - 코드베이스에 대해 묻는 질문

   • 선택 매개변수: codebase_file - 쿼리하기 전에 로드할 코드베이스 파일의 경로

코드베이스 준비

DeepView MCP에는 전체 코드베이스를 포함하는 단일 파일이 필요합니다. repomix를 사용하면 AI 친화적인 형식으로 코드베이스를 준비할 수 있습니다.

리포믹스 사용

1. 기본 사용법 : 프로젝트 디렉토리에서 repomix를 실행하여 기본 출력 파일을 만듭니다.

# Make sure you're using Node.js 18.17.0 or higher
npx repomix

이렇게 하면 코드베이스가 포함된 repomix-output.xml 파일이 생성됩니다.

2. 사용자 정의 구성 : 패키징할 파일과 출력 형식을 사용자 정의하기 위한 구성 파일을 만듭니다.

npx repomix --init

이렇게 하면 repomix.config.json 파일이 생성되고 이를 편집하여 다음 내용을 추가할 수 있습니다.

• 특정 파일이나 디렉토리 포함/제외

• 출력 형식(XML, JSON, TXT) 변경

• 출력 파일 이름을 설정합니다

• 다른 패키징 옵션 구성

예제 리포믹스 구성

다음은 repomix.config.json 파일의 예입니다.

{
  "include": [
    "**/*.py",
    "**/*.js",
    "**/*.ts",
    "**/*.jsx",
    "**/*.tsx"
  ],
  "exclude": [
    "node_modules/**",
    "venv/**",
    "**/__pycache__/**",
    "**/test/**"
  ],
  "output": {
    "format": "xml",
    "filename": "my-codebase.xml"
  }
}

repomix에 대한 자세한 내용은 repomix GitHub 저장소를 방문하세요.

특허

MIT

작가

드미트리 Degtyarev ( ddegtyarev@gmail.com )