Lupa — local file search for your Mac MCP Server

by under71 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. 16 installs a week from npm. Last commit 24 Oct 2026.

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

Installs per day peak 121 · avg 6 · -84% w/w

a month agotoday

Installs / week

npm · lupa-mcp

Stars

0 open issues

24 Oct 2026

Last commit

2 releases in 90 days

MIT

License

JavaScript

What the code does

We read the source, 8 min ago · rules 995398eba69f

Capabilities

What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.

Package points at a different repository under71/lupa-mcp

пакет lupa-mcp ссылается на paeyoungpark-web/lupa-mcp

Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.

This code can reach further than it looks

We found places where it runs commands, builds paths or queries from values it is given. None of that is a flaw by itself — it becomes one when the code changes, and code changes quietly between releases. We re-read it on every one.

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": {
      "command": "npx",
      "args": [
        "-y",
        "lupa-mcp"
      ]
    }
  }
}

~/.codex/config.toml

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

.cursor/mcp.json

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

.vscode/mcp.json

{
  "servers": {
    "lupa-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "lupa-mcp"
      ]
    }
  }
}

Alternatives to Lupa — local file search for your Mac

same job, measured the same way

Lupa — local file search for your Mac

by paeyoungpark-web

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

local only

Semlith

by semlith

Local search over your code and documents for AI agents.

local only

PDFluent

by pdfluent

Read, search and fill PDFs as markdown, text, tables, forms. Your documents stay on your machine.

361 installs/wk local only

Membase

by membase

Long-term memory for you and your AIs: search memories, read the profile, add facts and documents.

answering

Groupdocs Search MCP

by groupdocs-search

MCP server for GroupDocs.Search — index documents and run full-text search via AI agents.

local only

Apple Productivity MCP

by gambadio

Local macOS tools for Apple apps, iWork documents, files, media, and Shortcuts.

24 installs/wk local only

MCP Documentation Server

by andrea9293

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

59 installs/wk local only

MyMemory

by mymemory

Long-term memory for AI assistants: search, read and save your notes, links and documents.

295 installs/wk answering

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 was installed 16 times last week.

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 in the form that client actually reads. It runs locally, so the command pulls lupa-mcp straight from npm; nothing to host, nothing to sign up for.

How many people use Lupa — local file search for your Mac?

The npm package lupa-mcp was installed 16 times in the last week. Week over week that is -84%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.

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.