# MCP Image Analyzer Server

MCP server yang menganalisis gambar menggunakan vision AI model (mimo-v2.5-free) dan mengembalikan deskripsi detail untuk model tanpa vision.

## 📁 Struktur

```
mcp-image-analyzer/
├── main.py              # MCP server implementation
├── requirements.txt     # Python dependencies
└── .venv/              # Python virtual environment
```

## 🛠️ Tools yang Tersedia

### 1. `analyze_image`
Menganalisis gambar dengan instruksi custom atau analisis komprehensif.

**Parameters:**
- `image_path` (required): Path ke file gambar
- `instruction` (optional): Instruksi khusus untuk analisis

**Contoh Penggunaan:**
```python
# Analisis komprehensif (default)
analyze_image("/home/nyx/photo.jpg")

# Ekstrak teks saja
analyze_image("/home/nyx/screenshot.png", "Extract all visible text from this image")

# Deskripsi UI
analyze_image("/home/nyx/ui.png", "Describe the UI layout and components")

# Analisis kode
analyze_image("/home/nyx/code.png", "Extract the code and explain what it does")
```

### 2. `list_supported_formats`
Menampilkan daftar format gambar yang didukung.

## 🖼️ Format Gambar yang Didukung

- JPG/JPEG
- PNG
- GIF
- BMP
- WebP
- SVG
- TIFF
- HEIC
- ICO

## ⚙️ Konfigurasi

Sudah otomatis terintegrasi di `opencode.json`:

```json
"imageAnalyzer": {
  "command": "/home/nyx/.config/opencode/mcp-image-analyzer/.venv/bin/python",
  "args": ["/home/nyx/.config/opencode/mcp-image-analyzer/main.py"],
  "type": "local",
  "enabled": true
}
```

## 🔧 Setup & Maintenance

### Install Dependencies (jika diperlukan)
```bash
cd ~/.config/opencode/mcp-image-analyzer
uv pip install -r requirements.txt
```

### Test Server
```bash
~/.config/opencode/mcp-image-analyzer/.venv/bin/python main.py
```

### Update Dependencies
```bash
cd ~/.config/opencode/mcp-image-analyzer
uv pip install --upgrade -r requirements.txt
```

## 📊 Workflow

```
User: @image.png
      ↓
Qwen 3.7 Max (tanpa vision)
      ↓
Memanggil analyze_image tool
      ↓
Image Analyzer MCP
      ↓
Mimo-v2.5-free (Vision Model)
      ↓
Teks deskripsi detail
      ↓
Qwen 3.7 Max memahami isi gambar
```

## 🎯 Use Cases

1. **Screenshot Analysis**: Ekstrak teks dan deskripsi UI dari screenshot
2. **Code Review**: Analisis kode dari screenshot atau diagram
3. **Design Review**: Deskripsi layout dan komponen UI
4. **Document Analysis**: Ekstrak konten dari dokumen scan
5. **Image Description**: Deskripsi komprehensif untuk konteks

## 🐛 Troubleshooting

### Error: "File not found"
- Pastikan path gambar benar
- Gunakan absolute path atau path relatif dari home directory

### Error: "Unsupported image format"
- Cek ekstensi file
- Lihat daftar format yang didukung dengan `list_supported_formats`

### Error: "API Error" atau "Network Error"
- Pastikan vision API server berjalan di `http://192.168.1.10:20128/v1`
- Cek koneksi network
- Verifikasi API key valid

### MCP server tidak muncul di opencode
- Restart opencode
- Cek konfigurasi di `opencode.json`
- Pastikan file `main.py` executable

## 📝 Notes

- Output dalam Bahasa Inggris untuk kompatibilitas maksimal
- Model Qwen 3.7 Max dapat menentukan sendiri jenis analisis yang dibutuhkan
- Analisis komprehensif membutuhkan lebih banyak token
- Timeout API: 60 detik

## 🔗 Related

- Vision Model: `oc/mimo-v2.5-free`
- API Endpoint: `http://192.168.1.10:20128/v1`
- FastMCP Documentation: https://gofastmcp.com