Deepview MCP

🚀 DeepView MCP

DeepView MCP 是一个模型上下文协议（Model Context Protocol）服务器，它能让 Cursor 和 Windsurf 等 IDE 借助 Gemini 的大上下文窗口，对庞大的代码库进行分析，有效提升代码分析效率。

🚀 快速开始

DeepView MCP 可助力 IDE 利用 Gemini 强大的上下文窗口分析代码库。使用前，需确保满足以下先决条件，并完成安装与配置。

✨ 主要特性

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

📦 安装指南

使用 Smithery

若要通过 Smithery 自动将 DeepView 安装到 Claude 桌面，可执行以下命令：

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

使用 pip

使用以下命令通过 pip 进行安装：

pip install deepview-mcp

💻 使用示例

基础用法

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

# 基本用法，默认设置
deepview-mcp [代码库路径/代码库.txt]

# 指定不同的 Gemini 模型
deepview-mcp [代码库路径/代码库.txt] --model=gemini-pro

# 详细输出模式
deepview-mcp [代码库路径/代码库.txt] --verbose

高级用法

配置选项

• --model: 可用模型（例如：gemini, gemini-pro）
• --api-key: Gemini API 密钥
• --port: 监听端口，默认为 5000
• --verbose: 启用详细日志输出

示例配置文件

deepview-mcp --model=gemini-pro --api-key=your_api_key_here --port=5001 --verbose

命令行工具使用

deepview-mcp [路径] [--model=模型名称] [--api-key=密钥] [--port=端口] [--verbose]

• [路径]: 需要分析的代码库路径或文件。
• --model: 要使用的 Gemini 模型（默认：gemini）。
• --api-key: Gemini API 密钥。
• --port: 服务器监听的端口（默认：5000）。
• --verbose: 启用详细日志输出。

🔧 技术细节

准备代码库

示例代码库结构

your_project/
├── src/
│   ├── main.py
│   └── utils/
│       └── helper.py
└── tests/
    └── test_main.py

配置文件示例

repomix.config.json

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

📄 许可证

本项目采用 MIT 许可证。

作者

Dmitry Degtyarev (ddegtyarev@gmail.com)