Snapsearch Mcp

Created By
shantanukumar229 days ago
An AI agent + custom MCP server that sees your screenshots, understands what's in them, organizes them into clean folders, and lets you find anything with natural language. Fully local. No cloud uploads. No subscriptions.
Overview

🧠 snapsearch-mcp

Your screenshots folder is a disaster. snapsearch-mcp is a local-first AI-powered semantic search engine for screenshots on macOS/Windows . It uses vision models, embeddings, and vector search to understand screenshots, organize them automatically, and make them searchable using natural language.

✨ Features

  • 🔍 Semantic screenshot search
  • 🧠 GPT-4o Vision integration
  • 📂 Automatic organization into folders
  • 💾 Local ChromaDB vector storage
  • 🔒 Fully local workflow
  • ⚡ MCP-compatible for Claude Desktop
  • 🖥️ macOS optimized

🧩 Example

Search naturally:

find the react hooks error screenshot

Even if the filename is:

IMG_4829.png

snapsearch still finds it.


⚙️ How It Works

screenshot.png
GPT-4o Vision
Image understanding + OCR
text-embedding-3-small
ChromaDB vector storage
Natural language semantic retrieval


🔒 Privacy First

snapsearch runs entirely on your machine.

* screenshots never uploaded
* embeddings stored locally
* uses your own OpenAI API key
* no subscriptions
* no cloud backend


🧠 MCP Integration

Works with Claude Desktop through MCP.

Example config:

{
  "mcpServers": {
    "snapsearch": {
      "command": "snapsearch-mcp"
    }
  }
}


📦 Installation

pip install snapsearch-mcp


🚀 Vision

snapsearch is building toward an AI-native memory layer for your filesystem — where screenshots become searchable knowledge instead of forgotten clutter.

Server Config

{
  "mcpServers": {
    "snapsearch": {
      "command": "uvx",
      "args": [
        "snapsearch-mcp"
      ],
      "env": {
        "SCREENSHOTS_DIR": "/Users/yourname/Desktop",
        "OPENAI_API_KEY": "sk-..."
      }
    }
  }
}
Project Info
Created At
9 days ago
Updated At
9 days ago
Author Name
shantanukumar22
Star
-
Language
-
License
-
Category
Tags

Recommend Servers

View All