# mcpsurfr (MCP server)

> mcpsurfr is an MCP server that adds search and knowledge tools to AI assistants such as Claude Desktop, Claude Code and Cursor. Local web search with multi-engine deep research and on-device re-ranking. It has 135 GitHub stars, is released under the MIT license and runs locally with docker run -i --rm ghcr.io/nkapila6/mcpsurfr:v1.1.1.

Local web search for your LLM over MCP. No API keys, and results are ranked on your machine. Formerly mcp-local-rag. Backends: auto (default), brave, duckduckgo, google, grokipedia, mojeek, startpage, wikipedia, yahoo. auto and brave are the dependable ones.

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/nkapila6/mcpsurfr |
| GitHub stars | 135 |
| License | MIT |
| Language | Python |
| Transport | stdio |
| Packages | docker: ghcr.io/nkapila6/mcpsurfr:v1.1.1 |
| Remote URL | none |
| Needs API key | no |
| Official | no |
| Works with | Claude Desktop, Claude Code, Cursor, VS Code |
| Category | AI & search |
| Latest release | v1.1.1 (Oct 23, 2026) |
| Last commit | Oct 23, 2026 |
| MCP registry name | io.github.nkapila6/mcpsurfr |

## Install

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcpsurfr": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/nkapila6/mcpsurfr:v1.1.1"
      ]
    }
  }
}
```

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

### Claude Code

```sh
claude mcp add --transport stdio mcpsurfr -- docker run -i --rm ghcr.io/nkapila6/mcpsurfr:v1.1.1
```

### Cursor (.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcpsurfr": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/nkapila6/mcpsurfr:v1.1.1"
      ]
    }
  }
}
```

Project file; use ~/.cursor/mcp.json to enable it in every project.

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcpsurfr": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/nkapila6/mcpsurfr:v1.1.1"
      ]
    }
  }
}
```

Config formats checked against the official docs on 2026-10-07.

## Similar MCP servers

- [ContextLattice](https://appsgit.com/mcp-servers/contextlattice): Private-by-default, local-first memory/context/task orchestrator for MCP apps and agents. (156 stars, Apache-2.0)
- [Mindbase](https://appsgit.com/mcp-servers/mindbase): LLM-maintained personal wiki: cross-references sources, flags contradictions. (135 stars, MIT)
- [PDF MCP](https://appsgit.com/mcp-servers/pdf-mcp): Agentic RAG over one PDF or a whole folder: hybrid search, selective page reads, tables, OCR. (157 stars, MIT)
- [Brave Search MCP](https://appsgit.com/mcp-servers/brave-search-mcp): An MCP Server implementation that integrates the Brave Search API, providing, Web Search, Local Points of Interest Search, Image Search, Video Search, News Search and LLM Context Search capabilities. (130 stars, GPL-3.0, needs API key)
- [SerpApi](https://appsgit.com/mcp-servers/serpapi): Official SerpApi MCP server for Google, Bing, and other search engines. (182 stars, MIT, official, needs API key)
- [Hexis](https://appsgit.com/mcp-servers/hexis): Git-backed platform for skills, tools, and context for AI agents. (120 stars, Apache-2.0)

---

Canonical page: https://appsgit.com/mcp-servers/mcpsurfr
Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed daily.
Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.