lupa-mcp

Lass deinen KI-Agenten die Dokumente auf deinem Mac durchsuchen — nach dem, was in ihnen geschrieben steht.

Ein MCP-Server für Lupa, eine macOS-Dateisuch­app mit eigenem Index. Dein Agent fragt Lupa; Lupa antwortet aus einem lokalen Index in ~30 ms. Nichts läuft über das Netzwerk.

"find the contract that mentions the penalty clause"
        ↓
   lupa_search  →  ranked paths + matching snippets
   lupa_read    →  the document's text, without opening the file

Durchsucht Dateinamen und Dokumentinhalte: PDF, Word, Excel, PowerPoint, reiner Text, Hangul HWP/HWPX und gescannte PDFs per OCR.

Warum die anderes als find/grep

In dieser letzten Zeile liegt der springende Punkt. Dein Agent erhält die Dokumentinhalte, ohne dass du ihm Zugriff auf deine Festplatte gewähren musst.

Related MCP server: LocalSynapse

Voraussetzungen

Die Lupa-App muss installiert sein — dieser Server liest den Index, den Lupa erstellt; er indexiert selbst nichts.

1. Installiere Lupa (kostenlos) aus dem Mac App Store: https://lupa.kr

2. Öffne es, füge die Ordner, die duchsuchen werden sollen, hinzu und warte, bis die Indexierung fertig ist.

Nur für macOS.

Installation

Claude Code

claude mcp add lupa -- npx -y lupa-mcp

Claude Desktop / Cursor / jeder MCP-Client — füge in der MCP-Konfiguration des Clients Folgendes hinzu:

{
  "mcpServers": {
    "lupa": { "command": "npx", "args": ["-y", "lupa-mcp"] }
  }
}

Das war’s. Kein API-Schlüssel, kein Konto, keine Konfiguration.

Werkzeuge

lupa_search

lupa_read

File den Text zurück, den Lupa bereits aus einer Datei extrahiert hat — günstiger, als das Original zu lesen, und funktioniert auch mit Formaten, die dein Agent nicht parsieren kann. Voraussetzung: Lupa 1.1 oder neuer.

Suchsyntax

word1 word2      files matching ALL words rank first
n:word           file name only          (name:, 이름:, 文件名:)
c:word           document content only   (content:, 내용:, 内容:)
f:word           folder path contains    (폴더:, 文件夹:)
-word            exclude
"exact phrase"   literal match
.pdf  *.mp3  report*      extension / wildcard
kind:document    document · pdf · hwp · image · video · audio · code · archive · app
size:>10mb       size:<1mb
date:today       date:week · date:month · date:7d · date:2026-06

Koreanische und chinesische Präfixe funktionieren ebenfalls (종류: 크기: 날짜: / 种类: 大小: 日期:).

Koreanisch wird richtig verarbeitet — Teilwörter in zusammengesetzten Wörtern und angehängte Partikel werden beide gefunden; genau das macht Spotlight falsch.

Datenschutz

Alles läuft auf deinem Mac. Lupa enthält keinerlei Netzwerkcode, und dieser Server startet nur Lupas mitgeliefertes Kommandozeilen-Tool und übergibt die Ergebnisse an deinen Agent. Es wird nichts hochgeladen, und es gibt keine Telemetrie.

Hinweise

• Lupas kostenloser Index umfasst bis zu 50.000 Dateien. Dieser Server erbt einfach das, was die App indexiert hat — there is no separate limit or paywall here.

• Nur der Anfang jedes Dokuments wird indexiert, Informationen lupa_read lange Dateien.

• Falls Lupa an einem ungewöhnlichen veranstaltet installiert ist, setzte LUPA_SEARCH_PATH auf das lupa-search-Binary im App-Bundle.

Fehlerbehebung

Lizenz

MIT