Overview
The Filesystem MCP Server is a Go server that implements the Model Context Protocol (MCP) for performing various filesystem operations such as reading, writing, and managing files and directories.
To use the Filesystem MCP Server, install it via Go and configure it in your claude_desktop_config.json to specify the directories it can access.
- Read and write files - Create, list, and delete directories - Move files and directories - Search for files - Retrieve file metadata
- Managing files in a specified directory for applications.
- Automating file operations in development environments.
- Integrating with other tools that require filesystem access.
Add to your AI client
Use these steps to connect Filesystem MCP Server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.
Cursor
Add this to your .cursor/mcp.json file in your project root, then restart Cursor.
.cursor/mcp.json
{
"mcpServers": {
"mark3labs-mcp-filesystem-server-mcp-mirror": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mark3labs-mcp-filesystem-server-mcp-mirror"
]
}
}
}Claude Desktop
Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.
~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)
{
"mcpServers": {
"mark3labs-mcp-filesystem-server-mcp-mirror": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mark3labs-mcp-filesystem-server-mcp-mirror"
]
}
}
}Claude Code
Add this to your project's .mcp.json file. Claude Code will detect it automatically.
.mcp.json (project root)
{
"mcpServers": {
"mark3labs-mcp-filesystem-server-mcp-mirror": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mark3labs-mcp-filesystem-server-mcp-mirror"
]
}
}
}VS Code (Copilot)
Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.
.vscode/mcp.json
{
"servers": {
"mark3labs-mcp-filesystem-server-mcp-mirror": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mark3labs-mcp-filesystem-server-mcp-mirror"
]
}
}
}Windsurf
Add this to your Windsurf MCP config file, then restart Windsurf.
~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mark3labs-mcp-filesystem-server-mcp-mirror": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mark3labs-mcp-filesystem-server-mcp-mirror"
]
}
}
}Cline
Open Cline settings, navigate to MCP Servers, and add this server configuration.
Cline MCP Settings (via UI)
{
"mcpServers": {
"mark3labs-mcp-filesystem-server-mcp-mirror": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mark3labs-mcp-filesystem-server-mcp-mirror"
]
}
}
}FAQ
What operations can I perform with the server?
You can read, write, create, delete, move, and search for files and directories.
Is there a limit on the directories I can access?
Yes, the server only allows operations within directories specified in the configuration.
What programming language is the server written in?
The server is written in Go.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":1201,"uuid":"a2c7e45a-2340-4883-8775-1300b132e7bb","name":"mark3labs_mcp-filesystem-server","title":"Filesystem MCP Server","description":"Mirror of","avatar_url":"https://avatars.githubusercontent.com/u/192820360?v=4","created_at":"2025-01-28T02:38:08.485Z","updated_at":"2025-02-23T07:20:29.373Z","status":"created","author_name":"MCP-Mirror","author_avatar_url":"https://avatars.githubusercontent.com/u/192820360?v=4","tags":"filesystem,mcp,server","category":"developer-tools","is_featured":false,"sort":1,"url":"https://github.com/MCP-Mirror/mark3labs_mcp-filesystem-server","target":"_self","content":"$29","summary":"$2a","img_url":null,"type":null,"metadata":null,"user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]