- Add cost-focused headings to emphasize token management
- Include token cost multipliers in thinking modes table
- Add practical examples for each tool showing how to save tokens
- Provide specific token savings (e.g., "saves ~8k tokens")
- Guide users on when higher token costs are justified
- Remove recently added emoji indicators per request
This helps users make informed decisions about balancing response
quality with API costs across all tools.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
Major improvements for Windows users:
- Add detailed Windows Setup Guide with native and WSL options
- Create platform-specific example configurations (Windows/WSL/macOS)
- Add troubleshooting section addressing common Windows/WSL errors
- Create test_wsl_setup.bat diagnostic script for Windows users
Script improvements:
- Enhance run_gemini.bat with error handling and helpful messages
- Update both run scripts to use server.py as main entry point
- Keep gemini_server.py as backward compatibility wrapper
Documentation:
- Add clear instructions for both native Windows and WSL setups
- Explain the wsl.exe bridge approach for WSL users
- Include performance recommendations for WSL file access
- Add specific troubleshooting for spawn ENOENT errors
All tests passing, code properly formatted and linted.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
Major changes:
- Add comprehensive documentation to all modules with detailed docstrings
- Remove unused THINKING_MODEL config (use single GEMINI_MODEL with thinking_mode param)
- Remove list_models functionality (simplified to single model configuration)
- Rename DEFAULT_MODEL to GEMINI_MODEL for clarity
- Remove unused python-dotenv dependency
- Fix missing pydantic in setup.py dependencies
Documentation improvements:
- Document security measures in file_utils.py (path validation, sandboxing)
- Add detailed comments to critical logic sections
- Document tool creation process in BaseTool
- Explain configuration values and their impact
- Add comprehensive function-level documentation
Code quality:
- Apply black formatting to all files
- Fix all ruff linting issues
- Update tests to match refactored code
- All 63 tests passing
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Renamed tool from review_pending_changes to review_changes for brevity
- Enhanced tool descriptions for better MCP auto-discovery
- Updated all references throughout codebase including:
- Tool implementation (tools/review_changes.py)
- Test files (tests/test_review_changes.py)
- Server registration and imports
- Documentation in README.md
- Tool prompts in prompts/tool_prompts.py
- Enhanced review_changes description to emphasize pre-commit usage
- All tests pass, linting and formatting checks pass
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Move chat to position #1 as the most general and approachable tool
- Reorder all tool sections accordingly
- Update all anchor links and cross-references
- Update 'Why This Server' section to prioritize chat
- Better flow from general (chat) to specialized tools
- Add cool tagline emphasizing Claude + Gemini partnership
- Update acknowledgments section with proper credits for both AI systems
- Add inspiring message about combining their strengths
- Make the collaborative nature of the tool more prominent
- Added compelling highlight for the review_pending_changes tool
- Emphasizes deep analysis, edge case detection, and requirements validation
- Fixed anchor links for all tools to match correct section numbers
- Positions the tool as valuable for catching subtle bugs Claude might miss
- Add new review_pending_changes tool for comprehensive pre-commit reviews
- Implement filesystem sandboxing with MCP_PROJECT_ROOT
- Enforce absolute paths for all file/directory operations
- Add comprehensive git utilities for repository management
- Update all tools to use centralized path validation
- Add extensive test coverage for new features and security model
- Update documentation with new tool and path requirements
- Remove obsolete demo and guide files
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Add collaboration demo showing dynamic context requests
- Implement chat tool for general conversations and brainstorming
- Add tool selection guide with clear boundaries
- Introduce models configuration system
- Update prompts for better tool descriptions
- Refactor server to remove redundant functionality
- Add comprehensive tests for collaboration features
- Enhance base tool with collaborative features
This enables Claude to request additional context from Gemini
during tool execution, improving analysis quality and accuracy.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
Major improvements to thinking capabilities and API integration:
- Remove all output token limits for future-proof responses
- Add 5-level thinking mode system: minimal, low, medium, high, max
- Migrate from google-generativeai to google-genai library
- Implement native thinkingBudget support for Gemini 2.5 Pro
- Set medium thinking as default for all tools, max for think_deeper
🧠 Thinking Modes:
- minimal (128 tokens) - simple tasks
- low (2048 tokens) - basic reasoning
- medium (8192 tokens) - default for most tools
- high (16384 tokens) - complex analysis
- max (32768 tokens) - default for think_deeper
🔧 Technical Changes:
- Complete migration to google-genai>=1.19.0
- Remove google-generativeai dependency
- Add ThinkingConfig with thinking_budget parameter
- Update all tools to support thinking_mode parameter
- Comprehensive test suite with 37 passing unit tests
- CI-friendly testing (no API key required for unit tests)
- Live integration tests for API verification
🧪 Testing & CI:
- Add GitHub Actions workflow with multi-Python support
- Unit tests use mocks, no API key required
- Live integration tests optional with API key
- Contributing guide with development setup
- All tests pass without external dependencies
🐛 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Convert tool names to clickable links that jump to relevant sections
- Makes it easier for users to navigate directly to tool documentation
- Improves README navigation and user experience
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Add tool names in parentheses for each capability in "Why This Server?" section
- Expand "Start Using It\!" section to show all tools with arrow indicators
- Include examples for collaborative thinking (chat tool)
- Make it clearer which tool handles each type of request
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Update chat tool description to emphasize collaborative thinking capabilities
- Add explicit triggers for brainstorming and sharing ideas with Gemini
- Enhance prompt parameter description to include "current thinking"
- Update README to highlight chat as a thinking partner
- Update MCP_DISCOVERY.md with current tool names and enhanced examples
- Bump version to 2.5.0
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Add key capability highlight in the intro about reading files/directories
- Move File & Directory Support section up before Quickstart
- Remove duplicate Directory Support Features section from tool parameters
- Make the file handling capability more prominent as it's a core feature
This better communicates the server's primary strength of passing entire
codebases to Gemini for comprehensive analysis.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Change `relevant_files` to `files` in debug_issue tool
- Change `reference_files` to `files` in think_deeper tool
- Now all tools consistently use `files` parameter name
- Fix cross-platform test for Windows path separators
- Update README to reflect consistent parameter naming
This improves API consistency and reduces confusion when using different tools.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
Make documentation timeless by removing 'now' from feature description
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
Major improvements to file handling capabilities:
- Add directory traversal support to all file-processing tools
- Tools now accept both individual files and entire directories
- Automatically expand directories and discover code files recursively
- Smart filtering: skip hidden files, __pycache__, and non-code files
- Progressive token loading: read as many files as possible within limits
- Clear file separation markers with full paths for Gemini
Key changes:
- Rewrite file_utils.py with expand_paths() and improved read_files()
- Update all tool descriptions to indicate directory support
- Add comprehensive tests for directory handling and token limits
- Document tool parameters and examples in README
- Bump version to 2.4.2
All tools (analyze, review_code, debug_issue, think_deeper) now support:
- Single files: "analyze main.py"
- Directories: "review src/"
- Mixed paths: "analyze config.py, src/, tests/"
This enables analyzing entire projects or specific subsystems efficiently
while respecting token limits and providing clear file boundaries.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Add step 2 for cloning the repository with clear examples
- Provide separate macOS/Linux and Windows path examples
- Add explicit instructions to replace YOUR_USERNAME
- Include note about Windows double backslashes
- Make instructions crystal clear for new users
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
Makes it clearer that this server is specifically designed for Claude Code users
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Add MAX_OUTPUT_TOKENS constant set to 32,768 (Gemini 2.5 Pro's limit)
- Update all tools and chat handler to use MAX_OUTPUT_TOKENS
- Add comprehensive tests for output token configuration
- Update README with configuration details and system prompt docs
This fixes the issue where Gemini responses were being cut off at 8192 tokens,
causing Claude to repeatedly ask for the same analysis.
Fixes#1🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
Updated the configuration to use run_gemini.sh (macOS/Linux) or
run_gemini.bat (Windows) instead of directly calling Python.
The shell scripts properly:
- Set up the virtual environment
- Handle Python path resolution
- Run gemini_server.py (not server.py)
This ensures the server runs with the correct dependencies.
Added emphasis on Gemini 2.5 Pro's massive context window:
- 1 million token capacity
- Can analyze entire codebases at once
- Read hundreds of files simultaneously
- Provides comprehensive insights across large projects
This key differentiator shows why Gemini complements Claude so well
for large-scale code analysis and reviews.
Updated descriptions to emphasize that:
- Gemini provides a "second opinion" to augment Claude's extended thinking
- Claude has its own extended thinking capabilities
- Gemini complements rather than replaces Claude's analysis
- Added "edge cases Claude might miss" to show collaborative value
This makes it clear that both AIs can do deep thinking, but together
they provide more comprehensive analysis through different perspectives.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
Updated the API key section to mention:
- Free tier has limited access to latest models
- Paid API key recommended for best results with Gemini 2.5 Pro
This sets proper expectations about model availability and performance.
Cleaned up all collaborative examples:
- Removed sequential steps ("Step 1", "Step 2", etc.)
- Removed example labels ("Example 1 - ", etc.)
- Made each example a single, complete prompt showing full collaboration
- These are now natural prompts users can copy/paste to Claude Code
Each prompt now clearly shows the complete flow:
1. Claude does initial work
2. Shares with Gemini for review/extension
3. Incorporates Gemini's feedback
4. Presents final result to user
The examples are now clean, concise, and immediately usable.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
Restructured all collaborative examples to show they are prompts users send to Claude Code:
1. Removed confusing "[You do X]" placeholders
2. Added clear "Step 1:", "Step 2:" labels or "# First prompt:", "# Then:" comments
3. Shows these are sequential prompts users copy/paste to Claude Code
4. Made it clear Claude Code does the work, not the user
The flow is now obvious:
- User sends prompt 1 to Claude Code
- Claude Code responds
- User sends prompt 2 asking Claude Code to share with Gemini
- Continue the collaboration
This eliminates confusion about who is doing what and makes the examples immediately usable.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
Fixed all collaborative examples to show proper flow:
- User is talking TO Claude (not about Claude)
- Changed "Claude helped me" → proper instructions
- Changed "I've implemented" → "Implement X" [You implement]
- Workflows now show: User → Claude → Gemini → Claude
The perspective is now consistent:
1. User instructs Claude to do something
2. [You do it] - Claude performs the task
3. User instructs Claude to share with Gemini
4. [Gemini responds]
5. User instructs Claude to act on feedback
This makes the collaboration pattern clear and avoids confusion
about who is doing what in the conversation.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
Major improvements:
1. Added Claude + Gemini collaborative examples to each tool section
2. Removed entire Real-World Examples section (too verbose)
3. Simplified Power User Workflows to 4 clear patterns:
- Design → Review → Implement
- Code → Review → Fix → Verify
- Debug → Analyze → Solution
- Iterative Improvement
4. All examples now show Claude doing initial work, then Gemini reviewing/extending
The documentation is now:
- More focused on practical prompt examples
- Shows clear collaboration patterns
- Less verbose, more to-the-point
- Emphasizes the Claude + Gemini partnership
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
Major enhancements to all tool example prompts:
1. Added "gemini" to ALL prompts (users are asking Claude to use Gemini)
2. Structured examples progressively: Basic → Advanced → Real-world
3. Added parameter usage examples for each tool:
- think_deeper: focus_areas, reference_files, problem_context
- review_code: review_type, focus_on, standards, severity_filter
- debug_issue: error_context, relevant_files, runtime_info
- analyze: analysis_type, output_format, multiple files
- chat: context_files, temperature
4. Added detailed sections for each tool showing:
- Basic usage patterns
- Parameter-specific examples
- Advanced multi-parameter scenarios
- Real-world use cases
5. Improved Real-World Examples with more detail
6. Added 5 comprehensive Power User Workflows
7. Made Context Awareness examples use proper gemini prompts
All examples now clearly demonstrate how to use each tool effectively
with proper parameters and realistic scenarios.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Added numbers (1-7) to all tool section headers
- Updated anchor links in Quick Overview to match numbered headers
- Creates clear visual hierarchy showing these are the 7 main tools
- Professional numbering system matches the overview list
This makes it immediately clear which sections describe tools vs other content.
- Added 'Quick Overview' section listing all 7 tools
- Each tool in the list links to its detailed section via hash anchors
- Fixed heading levels for list_models and get_version (### instead of ####)
- Makes it easy to see all available tools at a glance and navigate to details
This improves documentation navigation and helps users quickly understand what tools are available.
- Removed '(Optional)' - this is essential for Claude Code users
- Corrected command to: claude mcp add-from-claude-desktop -s user
- Changed heading to 'Connect to Claude Code' to emphasize importance
This is the primary way users will interact with the MCP server via terminal.
Added back the crucial npx command for connecting MCP servers from Claude Desktop to Claude Code:
npx @anthropic-ai/claude-code mcp add-from-claude-desktop
This step is essential for users who want to use the Gemini MCP server in Claude Code after configuring it in Claude Desktop.
- Remove all emojis from section headings for cleaner appearance
- Remove Architecture section as requested
- Keep review category emojis (🔴🟠🟡🟢) in examples as they add value
Major redesign of Gemini MCP Server with modular architecture:
- Removed all emoji characters from tool outputs for clean terminal display
- Kept review category emojis (🔴🟠🟡🟢) per user preference
- Added 4 specialized tools:
- think_deeper: Extended reasoning and problem-solving (temp 0.7)
- review_code: Professional code review with severity levels (temp 0.2)
- debug_issue: Root cause analysis and debugging (temp 0.2)
- analyze: General-purpose file analysis (temp 0.2)
- Modular architecture with base tool class and Pydantic models
- Verbose tool descriptions with natural language triggers
- Updated README with comprehensive examples and real-world use cases
- All 25 tests passing, type checking clean, critical linting clean
BREAKING CHANGE: Removed analyze_code tool in favor of specialized tools
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
New tools:
- analyze_file: Clean file analysis without terminal clutter
- Always uses file paths, never shows content in terminal
- Server reads files directly and sends to Gemini
- Replaces analyze_code for file analysis use cases
- extended_think: Deep collaborative thinking with Claude
- Takes Claude's analysis/thoughts as input for deeper exploration
- Supports optional file context and focus areas
- Higher temperature (0.7) for creative problem-solving
- Designed for validating and extending Claude's analysis
Improvements:
- Added specialized system prompt for extended thinking
- Updated documentation with examples and workflows
- Added comprehensive tests for new tools
- Kept analyze_code for backward compatibility
This enables Claude and Gemini to work as true development partners,
with Claude doing primary analysis and Gemini providing validation,
alternative perspectives, and extended context processing.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Add section showing good vs bad prompts for file analysis
- Include pro tips in quickstart and practical usage sections
- Explain how mentioning "files parameter" keeps terminal clean
- Add multiple examples of proper prompt phrasing
This helps users understand how to analyze files without cluttering
their terminal with full file contents.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Update tool description to recommend file paths for large content
- Add note in README about terminal output behavior
- Explain that MCP client shows full parameters in terminal
- Guide users to save large content to files first
This helps users avoid terminal clutter when analyzing large code snippets.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Add type annotation for server variable
- Fix handling of optional parameters in chat and analyze_code handlers
- Rename request variable to request_analysis to avoid type confusion
- Fix model listing to handle missing attributes safely
- Remove emoji icons from README section headers
- Fix flake8 formatting issues (whitespace, line length)
All tests passing, mypy and flake8 checks now pass in CI.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
BREAKING CHANGE: Python 3.8 and 3.9 are no longer supported
- MCP package requires Python >=3.10 (all versions from 0.9.1 to 1.9.3)
- Update setup.py to require Python >=3.10
- Update GitHub Actions to only test Python 3.10, 3.11, and 3.12
- Update README.md with correct Python version requirement
- Remove typing-extensions dependency (not needed for Python 3.10+)
- Remove Python 3.8/3.9 from classifiers
This resolves all GitHub Actions failures for Python 3.8/3.9 tests.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Add Prerequisites section for clearer setup requirements
- Add Linux support with configuration paths and examples
- Add chmod +x instruction for script execution permissions
- Add comprehensive Troubleshooting section for common issues
- Add How It Works section explaining the architecture
- Improve run_gemini.sh to handle virtual environment gracefully
- Add absolute path examples for all operating systems
- Clarify error handling for Google safety filters
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Add explicit step to clone the repository first
- Include instructions for accessing config via Claude Desktop UI
- Clarify that users must replace placeholder paths with actual paths
- Add note to remember the cloned directory path
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Replaced generic examples with Claude-driven workflows
- Added examples showing Claude's extended thinking validated by Gemini
- Emphasized the feedback loop: Claude designs → Gemini validates → Claude refines
- Added real-world example flow for microservices architecture
- Updated best practices to position Claude as the primary thinker
- Made it clear that Gemini is for validation, edge cases, and extended context
This better reflects the intended usage pattern where Claude Code does the
heavy lifting and Gemini provides additional validation and context.
