Filesystem Context Mcp Server

Name: Filesystem Context Mcp Server
Author: j0hanz

@j0hanz

Repository

About Filesystem Context Mcp Server

Read-only MCP server for secure filesystem exploration, searching, and analysis

#filesystem #mcp #search #read-only #security

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "filesystem-context": {
      "command": "npx",
      "args": [
        "-y",
        "@j0hanz/filesystem-context-mcp"
      ]
    }
  }
}

Tools

Check accessible directories

List contents with sorting and metadata

JSON tree structure for AI parsing

Statistics: file counts, sizes, types

Find files by glob patterns

Grep-like regex search within files

Read single file with encoding options

Batch read multiple files in parallel

Read binary/media files as base64

Detailed metadata (size, MIME, permissions)

Overview

What is Filesystem Context Mcp Server?

Filesystem Context MCP Server is a read-only, security-first file system server designed to provide LLMs and AI agents with safe, structured access to local files and directories. It validates paths, blocks symlink escape attacks, and enriches file data with metadata for context-aware interactions.

How to use Filesystem Context Mcp Server?

Install via npx and configure the server to allow specific directories. Tools such as list_directory, read_file, search_files, search_content, and directory_tree are called through the Model Context Protocol interface to explore and read files without modifying them.

Key features of Filesystem Context Mcp Server

Security-first: read-only operations with strict path validation
Symlink protection prevents directory escape attacks
Batch operations for efficient parallel file reading
Rich metadata: file types, sizes, permissions, MIME types
Powerful search with glob patterns and regex content search
JSON directory tree for easy AI parsing

Use cases of Filesystem Context Mcp Server

Providing LLMs with safe context from local codebases or documentation
Searching file contents with regex for retrieval-augmented generation
Analyzing directory statistics to summarize project structure
Reading batch files in parallel to feed contextual data to AI agents

FAQ from Filesystem Context Mcp Server

What does read-only and security-first mean?

The server never writes or deletes files. Every file access is validated against allowed directories, and symlink traversal is blocked to prevent unauthorized access.

How are directories allowed?

Configurable via a directories setting in the MCP client; only those paths and their children are accessible.

Does it require any runtime besides Node.js?

Yes – installation uses npx, so Node.js and npm must be available. The server is a single command package.

Can it read binary files?

Yes, via read_media_file which returns binary files as base64 strings.

What transport does the server use?

The README does not specify a transport type; it is designed for the Model Context Protocol (stdio or HTTP likely). No authentication is mentioned.

Comments

More Files & Storage MCP servers

Filesystem MCP Server for WSL

webconsulting

filesystem MCP server for accessing WSL distributions from Windows

PDF Reader MCP Server (@sylphlab/pdf-reader-mcp)

sylphlab

📄 The PDF intelligence layer for AI agents — Agent Document Twin, evidence-first extraction, visual crops, OCR provenance, trust reports, and benchmark-gated releases. MCP server for Claude, Cursor, VS Code, and any MCP client.

810