Skip to content
MCP server

FileSystem MCP Server

Folder- and file-type-restricted local filesystem access for agents in Visual Studio

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, Windows, Linux
Runs
Locally
Version
0.1.4
Listing updated
today

Similar MCP servers

About FileSystem MCP Server

FileSystem MCP Server is an open-source MCP server for files and documents. It runs locally on your machine and is started by your AI client.

This Python server is aimed at Visual Studio 2022+ workflows without .code-workspace files, giving an AI agent selective access to project folders. Access is restricted to directories and file extensions you list, and writing is off unless you pass --allow-write or set allow_write in config.json. The README describes tools for listing allowed directories, reading files with allowed extensions, validating directory access, and (when enabled) write_file and write_file_binary, and suggests calling init first to check your configuration.

Configuration is hybrid: command-line arguments are used first for MCP clients, with a config.json fallback so you can press F5 in Visual Studio and debug with no arguments. Windows and Unix path separators both work. It installs from PyPI as vs-filesystem-mcp-server, needs Python 3.10+, and the README covers troubleshooting, security and how to edit mcp.json through GitHub Copilot Chat. This is version 0.1.4.

Install

Run in a terminal

claude mcp add filesystem-server -- uvx vs-filesystem-mcp-server

Add to claude_desktop_config.json

{
  "mcpServers": {
    "filesystem-server": {
      "command": "uvx",
      "args": [
        "vs-filesystem-mcp-server"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "filesystem-server": {
      "command": "uvx",
      "args": [
        "vs-filesystem-mcp-server"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "filesystem-server": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "vs-filesystem-mcp-server"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "filesystem-server": {
      "command": "uvx",
      "args": [
        "vs-filesystem-mcp-server"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "filesystem-server": {
      "command": "uvx",
      "args": [
        "vs-filesystem-mcp-server"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (3)

Taken from the project documentation; the running server may differ.

init
Checks configuration and directory access
write_file
Writes text content to a file when writing is enabled
write_file_binary
Writes binary content when writing is enabled

What it does

Directory allow-list
Only listed folders are reachable.
Extension filter
Only chosen file types can be read.
Opt-in writing
Text and binary writes are disabled by default.
Hybrid config
Command-line arguments with a config.json fallback.
Visual Studio debugging
Runs with no arguments for F5 debugging.
Cross-platform paths
Handles Windows and Unix separators.

Good for

  • Give Copilot in Visual Studio read access to a project folder
  • Let an agent read source files but not secrets by extension
  • Enable writes for a single scratch directory
  • Debug the server from Visual Studio

Pricing

Open source

FileSystem MCP Server FAQ

Is writing allowed?

Only if you opt in with --allow-write or allow_write in config.json.

How do I install it?

Run pip install vs-filesystem-mcp-server.

What should I call first?

The init tool, which reports configuration errors.

Which Python version is required?

Python 3.10 or newer.

Is FileSystem MCP Server free?

Yes. FileSystem MCP Server is open source, so you can use and self-host it for free.

How do I add FileSystem MCP Server to Claude Code?

Run this command in your terminal: claude mcp add filesystem-server -- uvx vs-filesystem-mcp-server

What are the best alternatives to FileSystem MCP Server?

The closest alternatives to FileSystem MCP Server are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers