MCP

Access and Manage Local Files Securely

Filesystem MCP connector for Claude: Securely read, write, list, create, move, and search local files with configurable access controls.


90
Spark score
out of 100
Updated 4 months ago
Version 1.0.0

Add to Favorites

Why it matters

Grant your AI secure, controlled access to your local filesystem. This connector allows AI models to read, write, list, create directories, move files, and search your file system within defined boundaries.

Outcomes

What it gets done

01

Read file contents

02

Write data to files

03

List directory contents

04

Search for files by pattern

Install

Add it to your toolbox

Run in your project directory:

curl -fsSL https://spark.entire.vc/get/vb-filesystem | bash

Capabilities

Tools your agent gets

read_file

Read the contents of a file.

write_file

Write content to a file.

list_directory

List contents of a directory.

create_directory

Create a new directory.

move_file

Move or rename a file.

search_files

Search for files matching a pattern.

Overview

Filesystem MCP

What it does

The Filesystem MCP server provides Claude with secure access to your local filesystem. It allows for reading file contents, writing data to files, listing directory contents, creating new directories, moving or renaming files, and searching for files using patterns. Access is restricted to specified directories with robust security measures.

How it connects

Use the Filesystem MCP when your Claude AI needs to interact with local files for tasks such as configuration management, data processing, log analysis, or any operation requiring read/write capabilities on your machine. It's ideal for controlled, secure file system interactions.

Source README

The Filesystem MCP server provides Claude with secure access to your local filesystem with configurable access controls.

Installation

npm install -g @modelcontextprotocol/server-filesystem

Configuration

Add to your Claude Code settings:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/path/to/allowed/directory"
      ]
    }
  }
}

Available Tools

read_file

Read the contents of a file.

read_file(path: string): string

write_file

Write content to a file.

write_file(path: string, content: string): void

list_directory

List contents of a directory.

list_directory(path: string): FileInfo[]

create_directory

Create a new directory.

create_directory(path: string): void

move_file

Move or rename a file.

move_file(source: string, destination: string): void

search_files

Search for files matching a pattern.

search_files(path: string, pattern: string): string[]

Security

  • Access is restricted to specified directories
  • No access to parent directories (..)
  • Configurable read/write permissions
  • Path validation and sanitization

Usage Example

Claude, please read the contents of ./config/settings.json
and update the database connection string.

Discussion

Questions & comments · 0

Sign In Sign in to leave a comment.