Deepview MCP

🚀 DeepView MCP

DeepView MCP 是一個模型上下文協議（Model Context Protocol）服務器，它讓 Cursor 和 Windsurf 等 IDE 能夠藉助 Gemini 的大上下文窗口對龐大的代碼庫進行分析。

🚀 快速開始

DeepView MCP 可助力 IDE 利用 Gemini 分析代碼庫。使用前，需滿足以下先決條件：

• Python 3.13+
• 來自 Google AI Studio 的 Gemini API 密鑰

✨ 主要特性

• 可從單個文本文件加載整個代碼庫（例如使用 repomix 等工具創建）。
• 能借助 Gemini 的大上下文窗口查詢代碼庫。
• 可連接到支持 MCP 協議的 IDE，如 Cursor 和 Windsurf。
• 支持通過命令行參數進行可配置的 Gemini 模型選擇。
• 提供代碼庫分析功能，可從單個文件加載整個代碼庫，並通過 Gemini 進行上下文分析。
• 支持多種 Gemini 模型，包括 gemini 和 gemini-pro。
• 支持通過命令行參數配置 API 密鑰和端點。

📦 安裝指南

使用 Smithery

要通過 Smithery 自動安裝 DeepView 到 Claude 桌面，可執行以下命令：

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

使用 pip

pip install deepview-mcp

💻 使用示例

啟動服務器

⚠️ 重要提示

您無需手動啟動服務器。這些參數在您的 IDE 的 MCP 設置中配置（見下文）。

基礎用法

# 基本用法，默認設置
deepview-mcp [代碼庫路徑/代碼庫.txt]

高級用法

# 指定不同的 Gemini 模型
deepview-mcp [代碼庫路徑/代碼庫.txt] --model=gemini-pro

# 詳細輸出模式
deepview-mcp [代碼庫路徑/代碼庫.txt] --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

配置文件示例

{
  "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)