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:

# 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:

"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)

cd ~/.config/opencode/mcp-image-analyzer
uv pip install -r requirements.txt

Test Server

~/.config/opencode/mcp-image-analyzer/.venv/bin/python main.py

Update Dependencies

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