MANUAL_INSTALL.md•4.61 kB
# Manual Installation Guide
If the automated install script doesn't work, follow these manual steps:
## ⚠️ Important: Python 3.10+ Required
The MCP package requires **Python 3.10 or higher**. Check your Python version:
```bash
python3 --version
# or
python3.11 --version
```
If you have Python 3.9 or lower, you need to install a newer version.
## 🐍 Install Python 3.10+
### macOS (Homebrew)
```bash
brew install python@3.11
```
### Ubuntu/Debian
```bash
sudo apt update
sudo apt install python3.11 python3.11-venv python3.11-pip
```
### CentOS/RHEL/Fedora
```bash
sudo dnf install python3.11 python3.11-pip
# or for older versions:
sudo yum install python311 python311-pip
```
### Windows
Download from [python.org](https://www.python.org/downloads/) and install Python 3.11
## 📦 Manual Installation Steps
1. **Clone the repository:**
```bash
git clone https://github.com/JayRajGoyal/gcp-mcp.git
cd gcp-mcp
```
2. **Create virtual environment:**
```bash
# Use the highest Python version you have (3.10+)
python3.11 -m venv venv
# or if you only have python3.10:
python3.10 -m venv venv
# or if python3 points to 3.10+:
python3 -m venv venv
```
3. **Activate virtual environment:**
```bash
# macOS/Linux:
source venv/bin/activate
# Windows:
venv\Scripts\activate
```
4. **Upgrade pip:**
```bash
python -m pip install --upgrade pip
```
5. **Install core dependencies:**
```bash
python -m pip install mcp structlog click pydantic python-dateutil typing-extensions
```
6. **Install Google Cloud dependencies:**
```bash
python -m pip install google-auth google-cloud-logging google-cloud-monitoring google-cloud-error-reporting
```
7. **Install optional resource manager (for multi-project support):**
```bash
python -m pip install google-cloud-resource-manager
```
8. **Install the GCP MCP package:**
```bash
python -m pip install -e .
```
9. **Test the installation:**
```bash
python -c "import gcp_mcp; print('✅ Installation successful!')"
python -m gcp_mcp.cli --help
```
## 🔧 Troubleshooting
### "No module named 'mcp'"
- Make sure you're using Python 3.10+
- Make sure your virtual environment is activated
- Try: `python -m pip install mcp`
### "ModuleNotFoundError: No module named 'google'"
- Install Google Cloud dependencies: `python -m pip install google-auth google-cloud-logging`
### "Permission denied" errors
- Make sure you're in a virtual environment
- On some systems, use `python3 -m pip install --user` instead
### "Command not found: python3.11"
- You need to install Python 3.11 first (see installation steps above)
- Or use whatever Python 3.10+ version you have installed
### Virtual environment activation issues
- **Linux/macOS**: `source venv/bin/activate`
- **Windows Command Prompt**: `venv\Scripts\activate.bat`
- **Windows PowerShell**: `venv\Scripts\Activate.ps1`
## 🧪 Verify Installation
Run the test suite to make sure everything works:
```bash
python3.11 test_setup.py
```
You should see:
```
📊 Test Results
==================================================
✅ Passed: 10
❌ Failed: 0
📈 Success Rate: 100.0%
🎉 All tests passed! The GCP MCP Server is ready to use.
```
## 🔗 Claude Code Integration
Once installed, add this to your Claude Code configuration:
```json
{
"mcpServers": {
"gcp": {
"command": "python3.11",
"args": [
"-m", "gcp_mcp.cli",
"--credentials", "/path/to/your/credentials.json"
],
"cwd": "/path/to/gcp-mcp"
}
}
}
```
Replace:
- `python3.11` with your Python command (`python3.10`, `python3`, etc.)
- `/path/to/your/credentials.json` with your actual credentials file path
- `/path/to/gcp-mcp` with the actual path to this directory
## 🆘 Still Having Issues?
1. **Check Python version**: Must be 3.10+
2. **Check virtual environment**: Make sure it's activated
3. **Check permissions**: Make sure you can write to the directory
4. **Try step by step**: Run each pip install command individually
5. **Check logs**: Look for specific error messages and search online
### Common Solutions
**If you have multiple Python versions:**
```bash
# Use the specific version that works
/usr/bin/python3.11 -m venv venv
source venv/bin/activate
python -m pip install --upgrade pip
python -m pip install mcp
# ... continue with other packages
```
**If pip is missing:**
```bash
# Install pip
curl https://bootstrap.pypa.io/get-pip.py | python3.11
```
**If you're behind a corporate firewall:**
```bash
# Use trusted hosts
python -m pip install --trusted-host pypi.org --trusted-host pypi.python.org --trusted-host files.pythonhosted.org mcp
```