--- title: "surf vs mcp-local-rag" type: "comparison" canonical_url: "https://www.graphcanon.com/compare/deta-surf-vs-shinpr-mcp-local-rag" tools: ["deta-surf", "shinpr-mcp-local-rag"] --- # surf vs mcp-local-rag *GraphCanon updated Sep 20, 2026* ## Verdict Pick surf if surf is an open-source tool for managing personal notes by integrating local or remote AI models to process files and webpages; pick mcp-local-rag if mcp-local-rag is designed for developers who prioritize privacy and ease of setup when performing semantic and keyword searches on local codebases and technical documents through MCP or CLI integration. [surf](https://deta.surf) reports 3.6k GitHub stars, 251 forks, and 32 open issues, last pushed Aug 24, 2026. [mcp-local-rag](https://github.com/shinpr/mcp-local-rag) has 400 stars, 74 forks, and 2 open issues, last pushed Sep 20, 2026. Figures are from public GitHub metadata via [surf's repository](https://github.com/deta/surf) and [mcp-local-rag's repository](https://github.com/shinpr/mcp-local-rag). | | [surf](/tools/deta-surf.md) | [mcp-local-rag](/tools/shinpr-mcp-local-rag.md) | | --- | --- | --- | | Tagline | Tools for organizing files and webpages locally to generate notes using personal AI notebooks. | Local-first RAG server for developers with semantic and keyword search capabilities. | | Stars | 3,572 | 400 | | Forks | 251 | 74 | | Open issues | 32 | 2 | | Language | TypeScript | TypeScript | | Adopt for | surf is an open-source tool for managing personal notes by integrating local or remote AI models to process files and webpages. | mcp-local-rag is designed for developers who prioritize privacy and ease of setup when performing semantic and keyword searches on local codebases and technical documents through MCP or CLI integration. | | Persona | - | - | | Runtime | - | - | | License | Apache-2.0 | MIT | | Categories | Data & Retrieval, Developer Tools, LLM Frameworks | Data & Retrieval, Developer Tools | ## Trust and health _Sourced signals - not a safety guarantee. No winner column._ | | [surf](/tools/deta-surf.md) | [mcp-local-rag](/tools/shinpr-mcp-local-rag.md) | | --- | --- | --- | | Maintenance | Active (82%) | Very active (96%) | | Days since push | 26d | 0d | | Open issues (now) | 32 | 2 | | Stars delta | +50 (30d) | +48 (30d) | | Open issues delta | 0 (30d) | -2 (30d) | | Owner type | Organization | User | | Full report | [trust report](/tools/deta-surf/trust.md) | [trust report](/tools/shinpr-mcp-local-rag/trust.md) | ## Decision facts: surf - **Adopt for:** surf is an open-source tool for managing personal notes by integrating local or remote AI models to process files and webpages. ## Decision facts: mcp-local-rag - **Adopt for:** mcp-local-rag is designed for developers who prioritize privacy and ease of setup when performing semantic and keyword searches on local codebases and technical documents through MCP or CLI integration. ## Choose when ### Choose surf if… - License: surf is Apache-2.0, mcp-local-rag is MIT. - Tags unique to surf: claude, deepseek, gemma, knowledge-base. - Also covers LLM Frameworks. - Need a robust integration with both local and remote language models for comprehensive note creation ### Choose mcp-local-rag if… - License: mcp-local-rag is MIT, surf is Apache-2.0. - Tags unique to mcp-local-rag: agent-skills, hybrid-search, local-first, privacy-first. - mcp-local-rag ships an MCP server manifest. - When you need to perform both semantic and keyword-based search operations within a local, privacy-focused environment tailored specifically for handling codebases and technical documentation. ## When NOT to use surf - Prefer using proprietary, closed-source tools that do not allow open model choices - Require extensive cloud-based collaboration features among multiple users ## When NOT to use mcp-local-rag - When you do not require a privacy-first approach and are willing to rely on cloud-based solutions that might offer more extensive feature sets beyond just keyword and semantic searches. - If your use case involves scaling search capabilities across multiple remote databases or servers, as mcp-local-rag is best suited for local data only. ## Common questions ### What is the difference between surf and mcp-local-rag? surf: Tools for organizing files and webpages locally to generate notes using personal AI notebooks.. mcp-local-rag: Local-first RAG server for developers with semantic and keyword search capabilities.. See the comparison table for live GitHub stats and shared categories. ### When should I choose surf over mcp-local-rag? Choose surf over mcp-local-rag when License: surf is Apache-2.0, mcp-local-rag is MIT; Tags unique to surf: claude, deepseek, gemma, knowledge-base; Also covers LLM Frameworks; Need a robust integration with both local and remote language models for comprehensive note creation. ### When should I choose mcp-local-rag over surf? Choose mcp-local-rag over surf when License: mcp-local-rag is MIT, surf is Apache-2.0; Tags unique to mcp-local-rag: agent-skills, hybrid-search, local-first, privacy-first; mcp-local-rag ships an MCP server manifest; When you need to perform both semantic and keyword-based search operations within a local, privacy-focused environment tailored specifically for handling codebases and technical documentation. ### When should I avoid surf? Prefer using proprietary, closed-source tools that do not allow open model choices Require extensive cloud-based collaboration features among multiple users ### When should I avoid mcp-local-rag? When you do not require a privacy-first approach and are willing to rely on cloud-based solutions that might offer more extensive feature sets beyond just keyword and semantic searches. If your use case involves scaling search capabilities across multiple remote databases or servers, as mcp-local-rag is best suited for local data only. ### Is surf or mcp-local-rag more popular on GitHub? surf has more GitHub stars (3,572 vs 400). Stars measure visibility, not whether either tool fits your constraints. ### Are surf and mcp-local-rag open source? Yes - both are open-source projects on GitHub (surf: Apache-2.0, mcp-local-rag: MIT). ### Where can I find alternatives to surf or mcp-local-rag? GraphCanon lists graph-backed alternatives at [surf alternatives](/tools/deta-surf/alternatives) and [mcp-local-rag alternatives](/tools/shinpr-mcp-local-rag/alternatives) ([surf markdown twin](/tools/deta-surf/alternatives.md), [mcp-local-rag markdown twin](/tools/shinpr-mcp-local-rag/alternatives.md)), ranked by typed relationship edges rather than popularity votes. ### Is there a machine-readable version of this comparison? Yes. The markdown twin at [this comparison](/compare/deta-surf-vs-shinpr-mcp-local-rag.md) mirrors this page for agents and LLM crawlers, with the same stats table and FAQ answers. ### Which is better maintained, surf or mcp-local-rag? surf: Active. mcp-local-rag: Very active. Compare maintenance labels, days since push, and release cadence in the trust section below - stars alone do not measure maintenance. ### Where are the full trust reports for surf and mcp-local-rag? GraphCanon publishes per-repo trust reports with dated maintenance, provenance, and scan summaries: [surf trust report](/tools/deta-surf/trust); [mcp-local-rag trust report](/tools/shinpr-mcp-local-rag/trust). --- **Machine-readable endpoints** - JSON: [`/api/graphcanon/graph?tool=deta-surf`](/api/graphcanon/graph?tool=deta-surf) - LLM index: [/llms.txt](/llms.txt) - Full corpus: [/llms-full.txt](/llms-full.txt) _GraphCanon - The knowledge graph for AI development. https://www.graphcanon.com/_