fix: add Python 3.10+ version check to setup scripts

- Add Python version validation in setup.sh and setup.bat
- Require Python 3.10 or higher (needed by mcp package)
- Provide clear error messages with upgrade instructions
- Update README prerequisites and troubleshooting sections

This prevents confusing dependency errors when users have older Python versions.

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

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
Fahad
2025-06-09 20:47:11 +04:00
parent 961925846c
commit de04ed0312
3 changed files with 57 additions and 5 deletions

View File

@@ -32,6 +32,10 @@ All tools accept both individual files and entire directories. The server:
## Quickstart (5 minutes)
### Prerequisites
- **Python 3.10 or higher** (required by the `mcp` package)
- Git
### 1. Get a Gemini API Key
Visit [Google AI Studio](https://makersuite.google.com/app/apikey) and generate an API key. For best results with Gemini 2.5 Pro, use a paid API key as the free tier has limited access to the latest models.
@@ -890,11 +894,16 @@ This error occurs when Claude Desktop (running on Windows) can't properly execut
### Common Issues
**"ModuleNotFoundError: No module named 'mcp'"**
- This means Python dependencies aren't installed
- **Solution**: Run the setup script:
- macOS/Linux: `./setup.sh`
- Windows: `setup.bat`
**"ModuleNotFoundError: No module named 'mcp'" or "No matching distribution found for mcp"**
- This means either:
1. Python dependencies aren't installed - run the setup script
2. Your Python version is too old - the `mcp` package requires Python 3.10+
- **Solution**:
- First check your Python version: `python3 --version` or `python --version`
- If below 3.10, upgrade Python from https://python.org
- Then run the setup script:
- macOS/Linux: `./setup.sh`
- Windows: `setup.bat`
- If you still see this error, manually activate the virtual environment and install:
```bash
# macOS/Linux: