feat: add comprehensive Windows/WSL support and documentation

Major improvements for Windows users:
- Add detailed Windows Setup Guide with native and WSL options
- Create platform-specific example configurations (Windows/WSL/macOS)
- Add troubleshooting section addressing common Windows/WSL errors
- Create test_wsl_setup.bat diagnostic script for Windows users

Script improvements:
- Enhance run_gemini.bat with error handling and helpful messages
- Update both run scripts to use server.py as main entry point
- Keep gemini_server.py as backward compatibility wrapper

Documentation:
- Add clear instructions for both native Windows and WSL setups
- Explain the wsl.exe bridge approach for WSL users
- Include performance recommendations for WSL file access
- Add specific troubleshooting for spawn ENOENT errors

All tests passing, code properly formatted and linted.

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

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
Fahad
2025-06-09 19:17:17 +04:00
parent 783ba73181
commit c220ad28eb
7 changed files with 235 additions and 7 deletions

View File

@@ -4,6 +4,21 @@ REM Windows batch script to run Gemini MCP server
REM Get the directory where this script is located
set SCRIPT_DIR=%~dp0
REM Activate the virtual environment and run the server
call "%SCRIPT_DIR%venv\Scripts\activate.bat"
python "%SCRIPT_DIR%gemini_server.py"
REM Check if virtual environment exists
if exist "%SCRIPT_DIR%venv\Scripts\activate.bat" (
REM Activate the virtual environment
call "%SCRIPT_DIR%venv\Scripts\activate.bat"
python "%SCRIPT_DIR%server.py"
) else (
REM Try to use python directly if no venv
echo Warning: Virtual environment not found at %SCRIPT_DIR%venv >&2
echo Attempting to run with system Python... >&2
python "%SCRIPT_DIR%server.py"
if errorlevel 1 (
echo Error: Failed to run server. Please ensure Python is installed and dependencies are available. >&2
echo Run: python -m venv venv >&2
echo Then: venv\Scripts\activate >&2
echo Then: pip install -r requirements.txt >&2
exit /b 1
)
)