L

Lupa — local file search for your Mac

MCP server · by paeyoungpark-web

Developer Tools npm v0.2.0

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

View source ↗ Website ↗ More servers

Install

Run one of the commands below, then add the client config underneath.

npmnpx -y lupa-mcp

Client configuration

Paste into Claude Desktop, Cursor (mcp.json), VS Code or any MCP client, then restart the client.

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

About this server

Lupa — local file search for your Mac is listed in the Developer Tools category of the MCPNav directory. It is distributed as npm and can be loaded by any client that speaks the Model Context Protocol.

Typical uses include giving your assistant scoped access to the corresponding service so it can answer questions and take actions with real data instead of guessing. Always review what a server can access before you enable it — see our MCP security guide.

Frequently asked questions

What is the Lupa — local file search for your Mac MCP server?

Lupa — local file search for your Mac is an MCP server by paeyoungpark-web. Search your Mac's files by name and by text inside documents. Local index, Korean-aware.

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

Install it with: npx -y lupa-mcp. Then add the JSON config to your client's MCP settings and restart the client.

Is Lupa — local file search for your Mac free to use?

The MCP server itself is free to install. The source is public on https://github.com/paeyoungpark-web/lupa-mcp. Any third-party API it calls (such as a search or maps API) may require its own key and billing.

Which clients support Lupa — local file search for your Mac?

Any MCP-compatible client can use it, including Claude Desktop, Cursor, VS Code, Windsurf and custom agents.