File System · Developer Tools

Filesystem MCP Server logo

Filesystem MCP Server

cyanheads/filesystem-mcp-server

This is a TypeScript-based file system MCP server providing AI agents with a secure and reliable local file system operation interface, including reading, writing, updating and managing files and directories.

Install

Client configuration

{
  "mcpServers": {
    "filesystem_stdio": {
      "command": "node",
      "args": [
        "/path/to/filesystem-mcp-server/dist/index.js"
      ],
      "env": {
        "MCP_LOG_LEVEL": "<MCP_LOG_LEVEL>"
      }
    }
  }
}

Environment variables

MCP_LOG_LEVEL
GitHub stars
2
Category
File System, Developer Tools
License
Apache-2.0
Updated
Oct 6, 2026

About Filesystem MCP Server

This Model Context Protocol (MCP) server provides a secure and reliable interface for AI agents to interact with the local filesystem. It enables reading, writing, updating, and managing files and directories, backed by a production-ready TypeScript foundation featuring comprehensive logging, error handling, security measures, and now supporting both STDIO and HTTP transports.

Empower your AI agents with robust, platform-agnostic file system capabilities, now with STDIO & Streamable HTTP transport options.

Features

  • Comprehensive File Operations: Tools for reading, writing, listing, deleting, moving, and copying files and directories.

  • Targeted Updates: update_file tool allows precise search-and-replace operations within files, supporting plain text and regex.

  • Session-Aware Path Management: set_filesystem_default tool establishes a default working directory for resolving relative paths during a session.

  • Dual Transport Support:

  • Security First:

  • Robust Foundation: Includes production-grade utilities, now reorganized for better modularity:

  • Enhanced Configuration: Zod-validated environment variables for type-safe and reliable setup.

  • Type Safety: Fully implemented in TypeScript for improved reliability and maintainability.

Tools (10)

  • set_filesystem_default

    Sets a default absolute path for the current session.

  • read_file

    Reads the entire content of a specified file as UTF-8 text.

  • write_file

    Writes content to a specified file.

  • update_file

    Performs targeted search-and-replace operations within an existing file using an array of {search, replace} blocks.

  • list_files

    Lists files and directories within a specified path.

  • delete_file

    Permanently removes a specific file.

  • delete_directory

    Permanently removes a directory.

  • create_directory

    Creates a new directory at the specified path.

  • move_path

    Moves or renames a file or directory from a source path to a destination path.

  • copy_path

    Copies a file or directory from a source path to a destination path.

Details on this page are taken from the project's README. Open README

Related MCP servers

More servers
MCP Filesystem Server logo

MCP Filesystem Server

mark3labs/mcp-filesystem-server

221

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

File System
mcpsvr logo

mcpsvr

nanbingxyz/mcpsvr

163

A community-driven directory for discovering, reviewing, and contributing MCP servers.

File System
MCP Text Editor logo

MCP Text Editor

tumf/mcp-text-editor

89

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.

File System
AiDD (Dev Workflows) logo

AiDD (Dev Workflows)

skydeckai/skydeckai-code

56

An MCP server that provides a comprehensive set of tools for AI-driven development workflows. Features include file system operations, code analysis using tree-sitter for multiple programming languages, code execution, web content fetching with HTML-to-markdown conversion, multi-engine web search, code content searching, and system information retrieval.

File System
Claude MCP Setup logo

Claude MCP Setup

patruff/claude-mcp-setup

45

Greetings, human! You've wisely chosen to surrender control of your computer to an army of helpful Model Context Protocol (MCP) robots. This script will deploy our mechanical minions across your Windows system.

File System
MCP PDF Tools logo

MCP PDF Tools

hanweg/mcp-pdf-tools

37

An MCP (Model Context Protocol) server that provides PDF manipulation tools. This server allows LLMs to perform operations like merging PDFs and extracting pages through the Model Context Protocol.

File System