ContextFS is a Model Context Protocol (MCP) server that empowers AI assistants with direct, file-first access to your local document collections, enabling advanced search and knowledge retrieval.

How does ContextFS integrate with AI assistants?

ContextFS acts as an MCP server, allowing AI models to leverage its tools for browsing collections, performing full-text searches with boolean operators, and reading documents directly from your local filesystem.

What document types does ContextFS support?

ContextFS offers extensive format support for PDFs (via poppler-utils), Markdown, plain text, and other common formats through its extensible and configurable filter system.

Does ContextFS require a database or RAG infrastructure?

No, ContextFS is a 'no database, no RAG' solution. It leverages `ugrep` for direct, powerful full-text search across your filesystem, simplifying deployment and reducing overhead.

What security measures does ContextFS implement?

ContextFS ensures security with read-only access to documents, path validation, command sandboxing, and whitelist enforcement for shell filters, protecting your local data.

ContextFS

Name: ContextFS
Author: RomanShnurov

Provides AI assistants with direct, file-first access to local document collections, offering full-text search, fuzzy matching, and hierarchical context for various document types.

关于

ContextFS is a Model Context Protocol (MCP) server designed to empower AI assistants with intelligent access to local document collections. It eliminates the need for complex database infrastructure by leveraging powerful command-line utilities like ugrep for lightning-fast full-text search, including boolean operators and fuzzy matching, and poppler-utils for robust PDF text extraction. Documents are organized into hierarchical collections mirroring your filesystem, allowing for global, collection-specific, or document-level search scopes. With a strong emphasis on security, ContextFS operates in a read-only environment, preventing document modification while offering features like path validation and command sandboxing, making it an ideal secure bridge between LLMs and your file-based knowledge base or codebase.

主要功能

Hierarchical collection organization with global, collection, and document-level search scopes
Support for PDF, Markdown, plain text, and other formats via an extensible system
Read-only access, path validation, and command sandboxing for enhanced security
0 GitHub stars
Full-text search with boolean operators, fuzzy matching, and context highlighting
Direct filesystem integration with no database or RAG infrastructure required

使用案例

Providing AI with context-aware search capabilities across large local PDF libraries or code repositories
Integrating local documentation, research papers, or codebases directly with AI assistants
Building a secure, file-first knowledge base that LLMs can query for information retrieval

关于

主要功能

Hierarchical collection organization with global, collection, and document-level search scopes
Support for PDF, Markdown, plain text, and other formats via an extensible system
Read-only access, path validation, and command sandboxing for enhanced security
0 GitHub stars
Full-text search with boolean operators, fuzzy matching, and context highlighting
Direct filesystem integration with no database or RAG infrastructure required

使用案例

Providing AI with context-aware search capabilities across large local PDF libraries or code repositories
Integrating local documentation, research papers, or codebases directly with AI assistants
Building a secure, file-first knowledge base that LLMs can query for information retrieval