javillegasna / filesystem

https://github.com/javillegasna/filesystem

Python server implementing Model Context Protocol (MCP) for filesystem operations.

Tools

Functions exposed to the LLM to take actions

read_file

Read complete contents of a file with UTF-8 encoding.

read_multiple_files

Read multiple files simultaneously without stopping on failed reads.

write_file

Create or overwrite a file with specified content.

edit_file

Make selective edits using pattern matching and formatting with dry run mode.

create_directory

Create a new directory or ensure it exists, creating parent directories if needed.

list_directory

List directory contents with [FILE] or [DIR] prefixes.

move_file

Move or rename files and directories, failing if the destination exists.

search_files

Recursively search for files/directories with case-insensitive matching.

get_file_info

Get detailed metadata of a file or directory.

list_allowed_directories

List all directories the server is allowed to access.

Prompts

Interactive templates invoked by user choice

No prompts

Resources

Contextual data attached and managed by the client

No resources

Author

javillegasna

Claim Ownership

Verify you have write access to the repository

Repository

GitHub Stars

License

MIT License

Last publish date

2025-05-02

Last update date

2025-08-18

Server configs

in claude desktop

{
  "mcpServers": {
    "filesystem": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/javillegasna/filesystem",
        "filesystem",
        "/Users/username/Desktop",
        "/path/to/other/allowed/dir"
      ]
    }
  }
}

in vscode

{
  "mcp": {
    "servers": {
      "filesystem": {
        "command": "uvx",
        "args": [
          "--from",
          "git+https://github.com/javillegasna/filesystem",
          "filesystem",
          "/Users/username/Desktop",
          "/path/to/other/allowed/dir"
        ]
      }
    }
  }
}

Top Comments

Related MCP Servers

View all file_systems servers →

mcp-filesystem-server

4.5

by mark3labs

This MCP server provides secure access to the local filesystem via the Model Context Protocol (MCP).

markdownify-mcp

4.5

by zcaceres

Markdownify is a Model Context Protocol (MCP) server that converts various file types and web content to Markdown format.

claude-code-mcp

4.4

by auchenberg

Claude Code MCP is an implementation of Claude Code as a Model Context Protocol (MCP) server, enabling its software engineering capabilities through a standardized interface.

DesktopCommanderMCP

4.3

by wonderwhy-er

Desktop Commander MCP is a tool that allows users to search, update, manage files, and run terminal commands using AI, without incurring API token costs.

mcp-everything-search

4.3

by mamertofabian

An MCP server that provides fast file searching capabilities across Windows, macOS, and Linux.

edgeone-pages-mcp

4.2

by TencentEdgeOne

An MCP service for deploying HTML content, folder, and zip file to EdgeOne Pages and obtaining a publicly accessible URL.

cloud_platforms

gistpad-mcp

4.2

by lostintangent

GistPad MCP is a server for managing and sharing personal knowledge, daily notes, and reusable prompts via GitHub Gists, integrated with VS Code and GistPad.dev.

knowledge_and_memory

python-mcp-server-client

4.1

by GobinFan

MCP Server is a server implementing the Model Context Protocol (MCP) to provide a standardized interface for AI models, connecting external data sources and tools like file systems, databases, or APIs.

vertex-ai-mcp-server

4.1

by shariqriazz

This project implements a Model Context Protocol (MCP) server that provides a comprehensive suite of tools for interacting with Google Cloud's Vertex AI Gemini models, focusing on coding assistance and general query answering.

mcp-text-editor

4.0

by tumf

A Model Context Protocol (MCP) server that provides line-oriented text file editing capabilities through a standardized API. Optimized for LLM tools with efficient partial file access to minimize token usage.

mcp-pdf-tools

4.0

by hanweg

An MCP server that provides PDF manipulation tools, allowing LLMs to perform operations like merging PDFs and extracting pages.

skydeckai-code

4.0

by skydeckai

SkyDeckAI Code is an MCP server offering a suite of tools for AI-driven development workflows, enhancing AI's ability to assist in software development by providing access to local and remote resources.

FileScopeMCP

3.9

by admica

FileScopeMCP is a TypeScript-based tool designed to analyze codebases, rank files by importance, track dependencies, and provide summaries to enhance code understanding.

Archive-Agent

3.8

by shredEngineer

Archive Agent is an open-source semantic file tracker with OCR and AI search capabilities.

mcp-obsidian

3.8

by MarkusPfundstein

MCP server to interact with Obsidian via the Local REST API community plugin.

claude-code-mcp

3.7

by steipete

An MCP (Model Context Protocol) server that allows running Claude Code in one-shot mode with permissions bypassed automatically.

obsidian-mcp

3.7

by StevenStavrakis

Obsidian MCP Server is a Model Context Protocol server that allows AI assistants to interact with Obsidian vaults, providing tools for managing notes and tags.

obsidian-mcp-tools

by jacksteamdev

MCP Tools for Obsidian enables AI applications like Claude Desktop to securely access and work with your Obsidian vault through the Model Context Protocol (MCP).

applescript-mcp

by joshrutkowski

A Model Context Protocol server that enables LLM applications to interact with macOS through AppleScript, providing a standardized interface for AI applications to control system functions, manage files, handle notifications, and more.

os_automation

mcp-client-server-markdown

by zou-hong-run

MCP Markdown Server is a server application based on the Model Context Protocol (MCP) that provides functionalities for creating, editing, searching, converting to HTML, and managing Markdown documents.

obsidian-mcp

by newtype-01

Obsidian MCP (Model Context Protocol) 服务器用于连接 AI 模型与 Obsidian 知识库，支持笔记和文件夹的管理操作。

knowledge_and_memory

mcp-server

by Apillon

The Apillon MCP Server provides modules for Storage, Hosting, and NFT functionalities using the Model Context Protocol (MCP).

cloud_storage

ebook-mcp

by onebirdrocks

Ebook-MCP is a Model Context Protocol server designed for processing electronic books, supporting EPUB and PDF formats.

UnityMCPIntegration

by quazaai

This package provides a seamless integration between Model Context Protocol (MCP) and Unity Editor, allowing AI assistants to understand and interact with Unity projects in real-time.

mcp-server-multiverse

by lamemind

A middleware server that enables multiple isolated instances of the same MCP servers to coexist independently with unique namespaces and configurations.

paperless-mcp

by nloui

An MCP server for managing documents, tags, correspondents, and document types in Paperless-NGX.

gdrive-mcp-server

by felores

A powerful Model Context Protocol (MCP) server that provides seamless integration with Google Drive, allowing AI models to search, list, and read files from Google Drive.