Skip to content

Conversation

eLyiN
Copy link

@eLyiN eLyiN commented Aug 25, 2025

Summary

Add gemini-bridge MCP server - a lightweight bridge connecting AI coding assistants to Google's Gemini AI via the official CLI.

Features

  • Zero API costs - Uses free Gemini CLI instead of paid API
  • Stateless operation - No sessions, caching, or complex state management
  • Universal compatibility - Works with Claude Code, Cursor, VS Code, and any MCP-compatible client
  • Production ready - Robust error handling with 60-second timeouts
  • Minimal dependencies - Only requires mcp>=1.0.0 and Gemini CLI
  • Two core MCP tools:
    • consult_gemini - Direct queries to Gemini
    • consult_gemini_with_files - File-aware analysis and code review

Repository

Docker Implementation

  • Multi-stage build with Node.js 20 + Python 3.11
  • Installs Gemini CLI via npm globally
  • Installs gemini-bridge from PyPI
  • Proper user permissions and security configuration
  • Entry point configured for MCP stdio transport

Test Plan

  • Docker image builds successfully
  • Gemini CLI properly installed and accessible
  • Python environment configured correctly
  • MCP server responds to requests
  • Error handling works as expected
  • No secrets or environment variables required

Ready for Docker team review and inclusion in the official MCP catalog.

Lightweight MCP server bridging AI coding assistants to Google's Gemini AI via official CLI. Features zero API costs, stateless operation, and seamless integration with Claude Code, Cursor, VS Code, and other MCP-compatible clients.

Key features:
- Direct Gemini CLI integration with no API costs
- Stateless architecture with 60-second timeouts
- Two core MCP tools: consult_gemini and consult_gemini_with_files
- Multi-stage Docker build with Node.js + Python
- Production-ready with proper error handling
- Compatible with any MCP-compatible AI coding assistant

Repository: https://github.com/shelakh/gemini-bridge
Category: AI tools
License: MIT
@eLyiN eLyiN requested a review from a team as a code owner August 25, 2025 20:14
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant