MCP Server Manager for Gemini CLI

A PowerShell script to easily manage Model Context Protocol (MCP) servers for the Gemini CLI. Add, remove, enable, disable, and view your MCP server configurations with simple commands.

🚀 Features

• List Servers: View active and disabled MCP servers.
• Enable/Disable: Quickly toggle servers on or off without deleting them.
• Add/Remove: Add new servers or permanently delete them.
• Auto-Detection: Automatically finds your Gemini CLI settings.json file.
• Safe: Creates a backup of your settings before making any changes.
• Validation & Repair: Checks for and offers to fix corrupted configuration files.

📋 Prerequisites

• PowerShell 5.1 or higher.
• Gemini CLI installed.

💾 Installation

1. Clone this repository or download the mcp-manager.ps1 script.
2. Place the script in a directory included in your system's PATH to make it accessible from anywhere.
3. Ensure the script is executable by running:

   Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

⚙️ Usage

The script is straightforward to use. Here are the available commands:

list (Default)

Lists all active and disabled MCP servers.

mcp-manager list

Simulated Output:

╔══════════════════════════════════════╗
║           ACTIVE MCP SERVERS         ║
╚══════════════════════════════════════╝

• filesystem [ACTIVE]
  Command: npx
  Args: -y @modelcontextprotocol/server-filesystem

╔══════════════════════════════════════╗
║          DISABLED MCP SERVERS        ║
╚══════════════════════════════════════╝

• chrome-devtools [DISABLED]
  Command: npx
  Args: -y @gemini-cli/chrome-mcp-server

add <name> <command> [args...]

Adds a new server to your active configuration.

mcp-manager add playwright npx -y @executeautomation/playwright-mcp-server

remove <name>

Permanently deletes a server from your configuration (active or disabled).

mcp-manager remove playwright

disable <name>

Disables an active server by moving it to settings.disabled.json. Gemini CLI will not use disabled servers.

mcp-manager disable filesystem

enable <name>

Enables a disabled server by moving it back to the main settings.json.

mcp-manager enable filesystem

status <name>

Checks the status (active/disabled) and configuration of a specific server.

mcp-manager status filesystem

help

Displays the full help message with all commands and examples.

🤝 Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change. Please make sure to update tests as appropriate.

📄 License

This project is licensed under the MIT License.