Files

Fahad 41c49c7169 docs: add detailed macOS setup instructions

- Create SETUP_MACOS.md with step-by-step guidance
- Include both automatic (setup.sh) and manual setup options
- Add troubleshooting for common issues
- Provide clear examples and Terminal tips
- Explain virtual environment usage for beginners

Helps macOS users properly set up the project environment.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

2025-06-09 20:57:43 +04:00

2.3 KiB

Raw Blame History

macOS Setup Instructions for Gemini MCP Server

Quick Setup (Recommended)

If you've already cloned the repository, simply run:

cd ~/gemini-mcp-server    # or wherever you cloned it
./setup.sh

This will automatically create a virtual environment and install all dependencies.

Manual Setup Instructions

1. Open Terminal and Navigate to Your Project

First, open Terminal (press ⌘ + Space, type "Terminal", press Enter).

Navigate to where you cloned the gemini-mcp-server:

# If you cloned to your home directory:
cd ~/gemini-mcp-server

# If you cloned elsewhere, replace with your path:
cd /path/to/gemini-mcp-server

Tip: You can drag the folder from Finder into Terminal to get the full path!

2. Check Your Python Version

Make sure you have Python 3.10 or newer:

python3 --version

If you see Python 3.9 or older, install a newer version:

# Using Homebrew (recommended):
brew install python@3.10

3. Create the Virtual Environment

Run this command in your project directory:

python3 -m venv venv

This creates a folder called venv in your project directory.

4. Activate the Virtual Environment

source venv/bin/activate

You'll see (venv) appear at the beginning of your Terminal prompt.

5. Install Dependencies

With the virtual environment activated:

pip install -r requirements.txt

Verifying Your Setup

After setup, you should have:

A venv folder in your gemini-mcp-server directory
All dependencies installed (no "ModuleNotFoundError")
The ability to run the server

Daily Usage

Each time you work with the project:

Navigate to the project directory
Activate the virtual environment: source venv/bin/activate
When done, deactivate: deactivate

Troubleshooting

"python3: command not found"

Install Python: brew install python@3.10

"Permission denied" errors

Make sure you're in the right directory
Try: chmod +x setup.sh then ./setup.sh

Still seeing "ModuleNotFoundError: No module named 'mcp'"

Make sure the virtual environment is activated (you should see (venv))
Re-run: pip install -r requirements.txt

Need Help?

If you're stuck, please share:

Your Python version: python3 --version
Your current directory: pwd
The exact error message you're seeing

2.3 KiB Raw Blame History