Filesystem Context Mcp Server

Name: Filesystem Context Mcp Server
Author: j0hanz

@j0hanz

代码仓库

关于 Filesystem Context Mcp Server

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

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

基本信息

分类

文件与存储

传输方式

stdio

发布者

j0hanz

提交者

Linus Johansson

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

工具

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)

概览

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.

文件与存储分类下的更多 MCP 服务器

md-pdf-mcp (Markdown to PDF MCP Server)

seanivore

Markdown To PDF Conversion MCP

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