gemini mcp

Here's a comprehensive `README.md` template for your Gemini MCP Docker project, formatted for GitHub:

```markdown
# Gemini MCP Docker Application

A Dockerized Python application implementing Model Context Protocol (MCP) with Google's Gemini API.

![Docker](https://img.shields.io/badge/Docker-✓-blue?logo=docker)
![Python](https://img.shields.io/badge/Python-3.9+-blue?logo=python)

## 📦 Features

- Dynamic context management via `.context` files
- Dockerized environment for dependency isolation
- Interactive CLI interface
- Supports Gemini 1.5 Flash and Pro models

## 🚀 Quick Start

### Prerequisites
- Docker Engine 20.10+
- Google Gemini API key ([Get one here](https://aistudio.google.com/app/apikey))

### Installation
```bash
git clone https://github.com/yourusername/gemini-mcp.git
cd gemini-mcp
```

### Configuration
1. Create `.env` file:
   ```bash
   cp .env.example .env
   ```
2. Edit `.env` with your API key:
   ```env
   GEMINI_API_KEY=your_key_here
   ```

### Build & Run
```bash
docker build -t gemini-mcp .
docker run -it --env-file .env gemini-mcp
```

## 🛠️ Project Structure
```
.
├── contexts/               # Context definition files
│   ├── technical.context  # Technical support context
│   └── creative.context   # Creative writing context
├── app.py                 # Main application
├── Dockerfile             # Docker configuration
├── requirements.txt       # Python dependencies
└── .env.example           # Environment template
```

## 💡 Usage Examples

### Technical Mode
```
Choose context: technical
Your prompt: How do I debug a Python segmentation fault?
```

### Creative Mode
```
Choose context: creative
Your prompt: Write a haiku about containerization
```

## 🧩 Adding New Contexts
1. Create new `.context` files in `contexts/` folder:
   ```bash
   echo "[SYSTEM CONTEXT: MEDICAL]" > contexts/medical.context
   echo "You are a medical AI assistant..." >> contexts/medical.context
   ```
2. The system will auto-detect new contexts on startup

## 🔧 Troubleshooting

### Common Issues
| Error | Solution |
|-------|----------|
| `Context not found` | Verify filename matches exactly |
| `API key invalid` | Regenerate key in Google AI Studio |
| `Docker build fails` | Check `requirements.txt` exists |

### Debugging
```bash
# Inspect container filesystem
docker run -it --entrypoint /bin/sh gemini-mcp
ls -la contexts/
```

## 📜 License
MIT License - See [LICENSE](LICENSE) for details

## 🤝 Contributing
1. Fork the project
2. Create your feature branch (`git checkout -b feature/AmazingFeature`)
3. Commit changes (`git commit -m 'Add amazing feature'`)
4. Push to branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request
```

Key features of this README:
1. **Badges** for quick visual scanning
2. **Structured sections** with clear headers
3. **Code blocks** with copy-paste friendly commands
4. **Troubleshooting table** for common issues
5. **Visual directory tree** for project navigation
6. **Contribution guidelines** for open-source readiness

To implement:
1. Save this as `README.md` in your project root
2. Update placeholder values (your GitHub URL, etc.)
3. Commit to Git:
   ```bash
   git add README.md
   git commit -m "Add comprehensive documentation"
   git push origin main
   ```

For enhanced documentation, consider adding:
- Screenshots of the CLI in action
- API rate limit information
- Docker Compose configuration examples
- CI/CD pipeline integration details