Gemini CLI MCP Servers

This repository contains a collection of custom MCP (Multi-Capability Provider) servers designed to extend the functionality of the Gemini CLI.

Initial Project Setup

Before installing the individual servers, it's recommended to set up the project environment.

1. Clone the Repository (if you haven't already):

   # Replace with the actual repository URL
   git clone https://github.com/your-username/gemini-cli-mcp-servers.git
   cd gemini-cli-mcp-servers
   

2. Set up the Virtual Environment: This project uses uv for environment and package management.

   # Create and activate a virtual environment
   uv venv
   source .venv/bin/activate
   
   # Install base dependencies
   uv pip install -e .
   

---

Available Servers

Below is a list of the available servers and how to install them into the Gemini CLI. The recommended installation method is using the fastmcp command-line tool.

1. PromptGen (/promptgen)

An MCP server to help refine user prompts based on a set of prompt engineering best practices.

• To Install:

  fastmcp install gemini-cli promptgen_server/main.py --name promptgen
  

• Usage:

  > /promptgen 'your simple prompt idea'
  

2. SuperAgent (/superagent)

A powerful orchestrator agent that follows an "Analyze -> Decide -> Formulate -> Delegate" loop to accomplish complex tasks by dispatching specialist agents.

• To Install:

  fastmcp install gemini-cli superagent_server/main.py --name superagent
  

• Usage:

  > /superagent 'your high-level goal here'
  

Important Setup for SuperAgent:

The SuperAgent requires a dedicated temporary directory for its operations. Please create the following directory in your home directory:

mkdir -p ~/tmp/gemini-tasks/

Additionally, you must inform the Gemini CLI about this new directory so it can write scratch files outside the current working directory. You can do this in one of two ways:

1. Using the Gemini CLI command:

   /directory add ~/tmp/gemini-tasks/
   

2. Manually editing settings.json: Add the following entry to your settings.json file, located in your .gemini/ folder:

     "context": {
       "ignore": [],
       "includeDirectories": [
         "/Users/ksprashanth/tmp/gemini-tasks"
       ]
     },
   

   (Note: Replace /Users/ksprashanth/tmp/gemini-tasks with the actual absolute path to your gemini-tasks directory if it's different.)

---

Disclaimer

This is not an officially supported Google product.

License

This project is licensed under the Apache License, Version 2.0. See the LICENSE file for details.