lupa-mcp

Разрешите вашему ИИ-агенту искать документы на вашем Mac — по тому, что написано внутри них.

MCP-сервер для Lupa, приложения для поиска файлов в macOS с собственным индексом. Ваш агент спрашивает у Lupa; Lupa отвечает из локального индекса за ~30 мс. Ничто не попадает в сет.

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

Ищет имена файлов и содержимое документов: PDF, Word, Excel, PowerPoint, обыный текст, Hangul HWP/HWPX и отсканные PDF-файлы, прочтанные м опомощью OCR.

Почему это, а не find/grep

Последная строка — и есть вся суть. Ваш агент получает содержимое документов без того, чтобы вы выдавали ему доступ к вашему диску.

Related MCP server: LocalSynapse

Требования

Приложение Lupa должно быть установлено — этот сервер читает индекс, который создает Lupa; сам он ничего не индексирует.

1. Установите Lupa (беослатно) из Mac App Store: https://lupa.kr

2. Откройте приложение, добавьте папки, по которым ищете, и дождитесь завершения индексации.

Только macOS.

Установка

Claude Code

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

Claude Desktop / Cursor / любой MCP-клиент — добавьте в конфигурацию MCP вашего клиента:

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

Вот и все. Без API-ключа, без аккаунта и без настройки.

Инструменты

lupa_search

lupa_read

Возвращает текст, который Lupa уже извлекла из файла — это легче, чем читать исходный файл, и работает для форматов, которые ваш агент не умеет разобрать. Требуется Lupa 1.1 или нове.

Синтаксис запросов

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

Кеко и китайские приставки тоже работают (종류: 크в: 날짜: / 种类: 大สิ: 日期:).

Корейский обрабатывается корректно. Поиск работает и по частым словососчетам, и по предлогженным частицам, — вот тут Spotlight ошибается.

Конфиденциальнность

Все выполняется на вашей Mac. Lupa не имеется ни кода работы с сетью, а этот сервер только запустляет командную строку Lupa внутри приложения и передает результат агенту. Ничего не выгружается, никакой телеметрии.

Примечания

• Бесплатный индекс Lupa охватывает до 50 000 файлов. Этот сервер наследует тем, что приложение уже проиндексировало, — здесь нет отдельного лимита или платы.

• Индексируется только начало каждого документа, поэтому lupa_read обрежается длинные файлы.

• Если Lupa установлена в нестандартном месте, задайте LUPA_SEARCH_PATH, указа остаток на бинер lupa-search в папке приложения.

Поникос

Лиензия

MIT