Van Damn MCP Server 💪

"I'll pump your context window up to 1M tokens!" - Van Damn (probably)

An MCP (Model Context Protocol) server that exposes Google Gemini 2.5 Pro's massive 1M context window to other AI coding assistants like Claude, Cursor, and more.

Features

• 🚀 Massive Context Window: Leverage Gemini 2.5 Pro's 1M token context
• 🤖 Universal Compatibility: Works with any MCP-compatible AI agent
• 🔧 Two Powerful Tools:
  • analyze_files: Read-only analysis of large codebases
  • process_files: Read, analyze, and optionally modify files
• 🎯 Easy Setup: Interactive wizard for quick configuration
• 🔐 Secure: Uses Google OAuth for authentication

Installation

npm install -g van-damn-mcp

Quick Start

1. Run the setup wizard:

van-damn setup

2. Follow the interactive prompts to:

   • Authenticate with your Google account
   • Configure Claude Code (or other MCP-compatible agents)

3. Start using Van Damn MCP in your AI coding assistant!

Available Tools

analyze_files

Analyzes files using Gemini 2.5 Pro's large context window.

Parameters:

• file_paths: Array of absolute file paths to analyze
• instructions: Natural language task or question

Example:

Analyze the entire codebase in /src and explain the architecture

process_files

Processes files with optional modifications.

Parameters:

• file_paths: Array of absolute file paths to process
• instructions: Natural language task or question
• review_only: If true (default), returns proposed changes; if false, applies changes

Example:

Refactor all TypeScript files to use modern ES modules

CLI Commands

• van-damn setup - Interactive setup wizard
• van-damn auth login - Login with Google account
• van-damn auth logout - Logout from Google account
• van-damn auth status - Check authentication status
• van-damn server --stdio - Start MCP server (usually called by AI agents)

Requirements

• Node.js 18 or higher
• A Google account with access to Gemini API
• An MCP-compatible AI coding assistant (e.g., Claude Code)

Development

This project is part of the gemini-cli ecosystem, forked and extended at github.com/leobuskin/van-damn-mcp.

Building from source

git clone https://github.com/leobuskin/van-damn-mcp
cd van-damn-mcp
npm install
cd packages/mcp
npm run build

Running tests

npm test

License

Apache-2.0

Support

For issues and feature requests, please visit GitHub Issues.

Remember: With great context comes great responsibility! 💪