Filesystem MCP Server logo

Filesystem MCP Server

by modelcontextprotocol

The Filesystem MCP Server is a Node.js server that implements the Model Context Protocol (MCP) for performing various filesystem operations. It allows reading, writing, creating, deleting, moving, and searching files and directories within specified allowed directories.

View on GitHub

Last updated: N/A

What is Filesystem MCP Server?

This server is a Node.js implementation of the Model Context Protocol (MCP) designed to provide a secure and controlled interface for interacting with the file system. It exposes a set of tools that allow authorized clients to perform operations such as reading, writing, and managing files and directories.

How to use Filesystem MCP Server?

To use the server, you need to configure it within a compatible environment like Claude Desktop. This involves specifying the server's command and arguments, including the allowed directories. You can run the server using Docker or NPX, ensuring that the necessary directories are mounted or specified as arguments. The API section describes the available tools and their inputs.

Key features of Filesystem MCP Server

  • Read/write files

  • Create/list/delete directories

  • Move files/directories

  • Search files

  • Get file metadata

  • Selective file edits with pattern matching

  • Directory access control

Use cases of Filesystem MCP Server

  • Allowing AI models to read and write files in a controlled environment

  • Enabling automated file management tasks

  • Providing a secure interface for file system access

  • Integrating file system operations into AI workflows

FAQ from Filesystem MCP Server

What is Model Context Protocol (MCP)?

MCP is a protocol for secure and controlled interaction between AI models and external resources.

How do I specify allowed directories?

Allowed directories are specified via the args parameter when configuring the server, either through Docker mounts or NPX arguments.

What happens if I try to access a file outside the allowed directories?

The server will deny access to any files or directories outside the specified allowed directories.

How can I preview changes before applying them with the edit_file tool?

Use the dryRun option set to true to preview changes and get detailed diff information without modifying the file.

What license is this server released under?

This MCP server is licensed under the MIT License.