DeepView MCP

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

功能

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

预备条件

• Python 3.13+
• 从Google AI Studio获取的Gemini API密钥

安装

通过Smithery安装

要通过Smithery自动安装DeepView for Claude Desktop：

npx -y @smithery/cli install @ai-1st/deepview-mcp --client claude

使用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)