FileSystem MCP Server
Folder- and file-type-restricted local filesystem access for agents in Visual Studio
- 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-serverAdd to claude_desktop_config.json
{
"mcpServers": {
"filesystem-server": {
"command": "uvx",
"args": [
"vs-filesystem-mcp-server"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"filesystem-server": {
"command": "uvx",
"args": [
"vs-filesystem-mcp-server"
]
}
}
}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.


