Lupa — local file search for your Mac MCP Server

by paeyoungpark-web Your server? Claim it

local only

Lupa — local file search for your Mac runs on your own machine — the client starts it, so there is no endpoint to ping. Last commit 21 Sep 2026.

Search your Mac's files by name and by text inside documents. Local index, Korean-aware.

—

Installs / week

npm · lupa-mcp

Stars

0 open issues

21 Sep 2026

Last commit

0 releases in 90 days

MIT

License

JavaScript

Nothing serious here today

Today is the operative word: we check Lupa — local file search for your Mac every 15 minutes and re-read its code on every release. Watch it and you find out the day that stops being true.

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

Claude Code Claude Desktop Codex Cursor VS Code

run in your terminal

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

~/Library/Application Support/Claude/claude_desktop_config.json

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

~/.codex/config.toml

[mcp_servers.lupa-mcp]
command = "npx"
args = ["-y", "lupa-mcp"]

.cursor/mcp.json

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

.vscode/mcp.json

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

Alternatives to Lupa — local file search for your Mac

same job, measured the same way

MCP Documentation Server

by andrea9293

Local-first document management and semantic search for AI coding agents

101 installs/wk local only

Ezel

by ezel

Search U.S. case law, fetch opinions, and ask matter-aware legal questions over your documents.

answering

Haypile

by benyd

Hybrid search over your local documents, with file and page citations. One binary, fully local.

local only

Qt4 Doc MCP Server

by jztan

Offline MCP server for local Qt 4.8, Qt 5, and Qt 6 documentation with full-text search.

87 installs/wk local only

Minirag MCP

by sfrangulov

Local-first RAG MCP server: hybrid search over a folder of your own documents

220 installs/wk local only

APICK OCR

by apick

OCR for images and Korean ID documents

6 tools answering

Meilisearch MCP

by mrfentmen

Search indexes, manage documents, check health and stats.

24 installs/wk local only

ContextPull

by mi2arun

Exact document sections on demand for LLM agents: index in context, search, read, grep, neighbours.

328 installs/wk local only

Lupa — local file search for your Mac — questions

Answers built from our own checks of this server.

Why is there no uptime for Lupa — local file search for your Mac?

Lupa — local file search for your Mac runs on your own machine over stdio — there is no network address to reach, so uptime cannot be measured for it by anyone. What can be measured is adoption: the npm package lupa-mcp.

How do I connect Lupa — local file search for your Mac?

Copy the ready config from this page — we generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each with the file path that client actually reads. It runs locally, so the command pulls lupa-mcp straight from npm; nothing to host, nothing to sign up for.

Is Lupa — local file search for your Mac open source?

Yes — it is published under the MIT licence, written in JavaScript and 0 stars on GitHub. The source link is on this page, so you can read exactly what it does with your data before you connect it.