Lupa — local file search for your Mac MCP Server
by paeyoungpark-webio.github.paeyoungpark-web/lupa-mcpv0.2.0
MCP server for Lupa — search your Mac's files by name and document content (PDF, DOCX, XLSX, PPTX, HWP, scanned PDFs via OCR). Korean-aware, ~30ms, fully local.
context tax
queued
security
queued
cold start
queued
freshness
Active18d ago
Install Lupa — local file search for your Mac MCP server
Install in Claude Code
claude mcp add lupa -- npx -y lupa-mcpInstall in Cursor
{
"mcpServers": {
"lupa": {
"command": "npx",
"args": [
"-y",
"lupa-mcp"
]
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"lupa": {
"command": "npx",
"args": [
"-y",
"lupa-mcp"
]
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"lupa": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"lupa-mcp"
]
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"lupa": {
"command": "npx",
"args": [
"-y",
"lupa-mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Freshness
Active — last maintenance signal 18d ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-09-21 · 18d ago · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-09-21 · 18d ago · official registry · v0.2.0
FAQ
›How do I install the Lupa — local file search for your Mac MCP server in Claude Code?
Run: claude mcp add lupa -- npx -y lupa-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does Lupa — local file search for your Mac require an API key?
No required environment variables are declared in its published metadata.
›Can I use Lupa — local file search for your Mac as a remote (hosted) MCP server?
No hosted endpoint is published; it runs locally over stdio.
›Is Lupa — local file search for your Mac in the official MCP registry?
Yes, as io.github.paeyoungpark-web/lupa-mcp.
Alternatives to Lupa — local file search for your Mac
Other productivity & office MCP servers.
BrowserActiveA fast, lightweight MCP server that empowers LLMs with browser automation via Puppeteer’s structured accessibility data, featuring optional vision mode for complex visual understanding and flexible, cross-platform configuration.
PlaywrightActivePlaywright browser automation: interact with web pages through structured accessibility snapshots.
BrowserActiveHeadless browser for AI and web automation with a built-in MCP server.
SkyvernActiveAI-powered browser automation — navigate, click, fill forms, and extract data from any website.
SeleniumBaseActiveBrowser automation, testing and bot-detection bypass using SeleniumBase CDP Mode with Chromium, including click-based CAPTCHA solving.
MobileActiveAndroid and iOS app and device automation, development and app scraping on simulators, emulators and physical devices.