DeepView MCP

DeepView MCP 是一个模型上下文协议服务器，它使像 Cursor 和 Windsurf 这样的 IDE 能够使用 Gemini 广泛的上下文窗口来分析大型代码库。

特性

• 从单个文本文件加载整个代码库（例如，使用像 repomix 这样的工具创建）
• 使用 Gemini 的大型上下文窗口查询代码库
• 连接到支持 MCP 协议的 IDE，例如 Cursor 和 Windsurf
• 可通过命令行参数配置 Gemini 模型选择

前提条件

• Python 3.13+
• 来自 Google AI Studio 的 Gemini API 密钥

安装

使用 pip

pip install deepview-mcp

用法

启动服务器

注意：您不需要手动启动服务器。这些参数在您的 IDE 的 MCP 设置中配置（见下文）。

# 具有默认设置的基本用法
deepview-mcp [path/to/codebase.txt]

# 指定不同的 Gemini 模型
deepview-mcp [path/to/codebase.txt] --model gemini-2.0-pro

# 更改日志级别
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 友好的格式准备您的代码库。

使用 repomix

1. 基本用法: 在您的项目目录中运行 repomix 以创建默认输出文件：

# 确保您使用的是 Node.js 18.17.0 或更高版本
npx repomix

这将生成一个包含您的代码库的 repomix-output.xml 文件。

2. 自定义配置: 创建一个配置文件以自定义要打包的文件和输出格式：

npx repomix --init

这将创建一个 repomix.config.json 文件，您可以编辑该文件以：

• 包含/排除特定文件或目录
• 更改输出格式（XML、JSON、TXT）
• 设置输出文件名
• 配置其他打包选项

repomix 配置示例

这是一个 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

作者

Dmitry Degtyarev (ddegtyarev@gmail.com)