Mitek99/deepview-mcp

DeepView MCP is a Model Context Protocol server that enables IDEs like Cursor and Windsurf to analyze large codebases using Gemini's extensive context window.
Features
- Load an entire codebase from a single text file (e.g., created with tools like repomix)
- Query the codebase using Gemini's large context window
- Connect to IDEs that support the MCP protocol, like Cursor and Windsurf
- Configurable Gemini model selection via command-line arguments
Prerequisites
- Python 3.13+
- Gemini API key from Google AI Studio
Installation
Installing via Smithery
To install DeepView for Claude Desktop automatically via Smithery:
Using pip
Usage
Starting the Server
Note: you don't need to start the server manually. These parameters are configured in your MCP setup in your IDE (see below).
The codebase file parameter is optional. If not provided, you'll need to specify it when making queries.
Command-line Options
- --model MODEL: Specify the Gemini model to use (default: gemini-2.0-flash-lite)
- --log-level {DEBUG,INFO,WARNING,ERROR,CRITICAL}: Set the logging level (default: INFO)
Using with an IDE (Cursor/Windsurf/...)
1. Open IDE settings
2. Navigate to the MCP configuration
3. Add a new MCP server with the following configuration:
json
{
"mcpServers": {
"deepview": {
"command": "/path/to/deepview-mcp",
"args": ["/path/to/codebase.txt"],
"env": {
"GEMINI_API_KEY": "your_gemini_api_key"
}
}
}
}
json
{
"mcpServers": {
"deepview": {
"command": "/path/to/deepview-mcp",
"args": ["--model", "gemini-2.5-pro-exp-03-25"],
"env": {
"GEMINI_API_KEY": "your_gemini_api_key"
}
}
}
}
bash
Make sure you're using Node.js 18.17.0 or higher
npx repomix
bash
npx repomix --init
json
{
"include": [
"**/*.py",
"**/*.js",
"**/*.ts",
"**/*.jsx",
"**/*.tsx"
],
"exclude": [
"node_modules/**",
"venv/**",
"**/__pycache__/**",
"**/test/**"
],
"output": {
"format": "xml",
"filename": "my-codebase.xml"
}
}
`
For more information on repomix, visit the repomix GitHub repository.