GemForge (Gemini Tools)

by PV-Bhat

4 stars

459 downloads

Not rated

GitHub

About

MCP server to empower your agent with enterprise-grade Gemini integration for codebase analysis, live search, text/PDF/image processing, and more on your favorite MCP clients.

Details

Author: PV-Bhat
GitHub stars: 4
Downloads: 459
Categories: AI, File Management, Developer Tools, Other

- Real‑time web access via gemini_search
- Advanced step‑by‑step reasoning with gemini_reason
- Full repository code analysis and generation with gemini_code
- Multi‑file processing for 60+ formats with gemini_fileops
- Intelligent automatic model selection per task
- Automatic fallbacks, rate‑limit management, and exponential backoff

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name GemForge (Gemini Tools)

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "gemforge (gemini tools)": {
            "GemForge": {
                "command": "node",
                "args": [
                    "./dist/index.js"
                ],
                "env": {
                    "GEMINI_API_KEY": "Apikeyhere"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "gemforge (gemini tools)": {
            "GemForge": {
                "command": "node",
                "args": [
                    "./dist/index.js"
                ],
                "env": {
                    "GEMINI_API_KEY": "Apikeyhere"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "gemforge (gemini tools)": {
            "GemForge": {
                "command": "node",
                "args": [
                    "./dist/index.js"
                ],
                "env": {
                    "GEMINI_API_KEY": "Apikeyhere"
                }
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "gemforge (gemini tools)": {
            "GemForge": {
                "command": "node",
                "args": [
                    "./dist/index.js"
                ],
                "env": {
                    "GEMINI_API_KEY": "Apikeyhere"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "gemforge (gemini tools)": {
            "GemForge": {
                "command": "node",
                "args": [
                    "./dist/index.js"
                ],
                "env": {
                    "GEMINI_API_KEY": "Apikeyhere"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "gemforge (gemini tools)": {
            "GemForge": {
                "command": "node",
                "args": [
                    "./dist/index.js"
                ],
                "env": {
                    "GEMINI_API_KEY": "Apikeyhere"
                }
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "gemforge (gemini tools)": {
            "GemForge": {
                "command": "node",
                "args": [
                    "./dist/index.js"
                ],
                "env": {
                    "GEMINI_API_KEY": "Apikeyhere"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "gemforge (gemini tools)": {
            "GemForge": {
                "command": "node",
                "args": [
                    "./dist/index.js"
                ],
                "env": {
                    "GEMINI_API_KEY": "Apikeyhere"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "gemforge (gemini tools)": {
            "GemForge": {
                "command": "node",
                "args": [
                    "./dist/index.js"
                ],
                "env": {
                    "GEMINI_API_KEY": "Apikeyhere"
                }
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "gemforge (gemini tools)": {
            "GemForge": {
                "command": "node",
                "args": [
                    "./dist/index.js"
                ],
                "env": {
                    "GEMINI_API_KEY": "Apikeyhere"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "gemforge (gemini tools)": {
            "GemForge": {
                "command": "node",
                "args": [
                    "./dist/index.js"
                ],
                "env": {
                    "GEMINI_API_KEY": "Apikeyhere"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "gemforge (gemini tools)": {
            "GemForge": {
                "command": "node",
                "args": [
                    "./dist/index.js"
                ],
                "env": {
                    "GEMINI_API_KEY": "Apikeyhere"
                }
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "gemforge (gemini tools)": {
            "GemForge": {
                "command": "node",
                "args": [
                    "./dist/index.js"
                ],
                "env": {
                    "GEMINI_API_KEY": "Apikeyhere"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "gemforge (gemini tools)": {
            "GemForge": {
                "command": "node",
                "args": [
                    "./dist/index.js"
                ],
                "env": {
                    "GEMINI_API_KEY": "Apikeyhere"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "gemforge (gemini tools)": {
            "GemForge": {
                "command": "node",
                "args": [
                    "./dist/index.js"
                ],
                "env": {
                    "GEMINI_API_KEY": "Apikeyhere"
                }
            }
        }
    }
}

From the repository

Install with npx @gemforge/mcp-server@latest init or manually via npm install gemforge-mcp. Configure the MCP client with the path to the server binary and set the GEMINI_API_KEY environment variable. Invoke tools such as gemini_search, gemini_reason, gemini_code, and gemini_fileops from your agent.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "gemforge (gemini tools)": {
            "GemForge": {
                "command": "node",
                "args": [
                    "./dist/index.js"
                ],
                "env": {
                    "GEMINI_API_KEY": "Apikeyhere"
                }
            }
        }
    }
}

McpServers

{
    "GemForge": {
        "command": "node",
        "args": [
            "./dist/index.js"
        ],
        "env": {
            "GEMINI_API_KEY": "Apikeyhere"
        }
    }
}

GemForge (Gemini Tools)

Overview

GemForge-Gemini-Tools-MCP: Enterprise-grade Gemini integration for your favorite MCP agents. Supercharge Claude, Roo Code, and Windsurf with codebase analysis, live search, text/PDF/image processing, and more.

Quick Navigation

- Features
- Quick Start
- Configuration
- Tools
- Heavy-Duty Reliability
- Deployment
- Examples
- Community
- Documentation

Why GemForge?

GemForge is the essential bridge between Google's Gemini AI and the MCP ecosystem:
gemfog

- Real-Time Web Access: Fetch breaking news, market trends, and current data with gemini_search
- Advanced Reasoning: Process complex logic problems with step-by-step thinking via gemini_reason
- Code Mastery: Analyze full repositories, generate solutions, and debug code with gemini_code
- Multi-File Processing: Handle 60+ file formats including PDFs, images, and more with gemini_fileops

- Intelligent Model Selection: Automatically routes to optimal Gemini model for each task

- Enterprise-Ready: Robust error handling, rate limit management, and API fallback mechanisms

Quick Start

One-Line Install

npx @gemforge/mcp-server@latest init

Manual Setup

1. Create configuration file (claude_desktop_config.json):

{
  "mcpServers": {
    "GemForge": {
      "command": "node",
      "args": ["./dist/index.js"],
      "env": {
        "GEMINI_API_KEY": "your_api_key_here"
      }
    }
  }
}

2. Install and run:

npm install gemforge-mcp
npm start

Watch 30-second setup demo →

Heavy-Duty Reliability

GemForge is built for production environments:

- Support for 60+ File Types: Process everything from code to documents to images
- Automatic Model Fallbacks: Continues functioning even during rate limits or service disruptions
- Enterprise-Grade Error Logging: Detailed diagnostics for troubleshooting
- API Resilience: Exponential backoff, retry logic, and seamless model switching
- Full Repository Support: Analyze entire codebases with configurable inclusion/exclusion patterns
- XML Content Processing: Specialized handling for structured data

Key Tools

| Tool | Description | Key Capability |
|------|-------------|----------------|
| gemini_search | Web-connected information retrieval | Real-time data access |
| gemini_reason | Complex problem solving with step-by-step logic | Transparent reasoning process |
| gemini_code | Deep code understanding and generation | Full repository analysis |
| gemini_fileops | Multi-file processing across 60+ formats | Document comparison and transformation |

<details>
<summary>Example: Real-Time Search</summary>

{
  "toolName": "gemini_search",
  "toolParams": {
    "query": "Latest advancements in quantum computing",
    "enable_thinking": true
  }
}

</details>

<details>
<summary>Example: Code Analysis</summary>

{
  "toolName": "gemini_code",
  "toolParams": {
    "question": "Identify improvements and new features",
    "directory_path": "path/to/project",
    "repomix_options": "--include \"/.js\" --no-gitignore"
  }
}

</details>
<details>
<summary>Example: Multi-File Comparison</summary>

{ "toolName": "gemini_fileops", "toolParams": { "file_path": ["contract_v1.pdf", "contract_v2.pdf"], "operation": "analyze", "instruction": "Compare these contract versions and extract all significant changes." } }
</details>
Configuration

GemForge offers flexible configuration options:

<details>
<summary>Environment Variables</summary>

GEMINI_API_KEY=your_api_key_here # Required: Gemini API key GEMINI_PAID_TIER=true # Optional: Set to true if using paid tier (better rate limits) DEFAULT_MODEL_ID=gemini-2.5-pro # Optional: Override default model selection LOG_LEVEL=info # Optional: Set logging verbosity (debug, info, warn, error)
</details>
<details>
<summary>Claude Desktop Integration</summary>

{ "mcpServers": { "GemForge": { "command": "node", "args": ["./dist/index.js"], "env": { "GEMINI_API_KEY": "your_api_key_here" } } } }
</details>
<details>
<summary>Advanced Model Selection</summary>

GemForge intelligently selects the best model for each task:
- gemini_search: Uses gemini-2.5-flash for speed and search integration
- gemini_reason: Uses gemini-2.5-pro for deep reasoning capabilities
- gemini_code: Uses gemini-2.5-pro for complex code understanding
- gemini_fileops: Selects between gemini-2.0-flash-lite or gemini-1.5-pro based on file size

Override with model_id parameter in any tool call or set DEFAULT_MODEL_ID environment variable.
</details>

Deployment

Smithery.ai
One-click deployment via Smithery.ai
Docker

docker run -e GEMINI_API_KEY=your_api_key ghcr.io/pv-bhat/gemforge:latest

Self-Hosted
Use our MCP.so Directory listing for integration instructions.
What Sets GemForge Apart?
- Cross-Ecosystem Power: Bridge Google's AI with Claude and other MCP agents
- Multi-File Analysis: Compare documents, images, or code versions
- Smart Routing: Automatic model selection based on task requirements
- Production-Ready: Built for enterprise environments

Community & Support

- Join Us: MCP Discord | GemForge Discord
- Contribute: GitHub Discussions
- Feedback*: Open an issue or share thoughts on Discord

Documentation

Visit our Documentation Site for:
- Advanced usage tutorials
- API reference
- Troubleshooting tips

License

Licensed under the MIT License. See LICENSE for details.

Acknowledgments

- Google Gemini API for providing the underlying AI capabilities - Model Context Protocol (MCP) for standardizing AI tool interfaces

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

GemForge (Gemini Tools)

Overview

Quick Navigation

Why GemForge?

Quick Start

One-Line Install

Manual Setup

Heavy-Duty Reliability

Key Tools

Configuration

Deployment

Smithery.ai

Docker

Self-Hosted

What Sets GemForge Apart?

Community & Support

Documentation

License

Acknowledgments

Install

More like this

Sentry

Github

Git

GitLab

Context 7

1Panel