About Filesystem MCP Server
A Go implementation of an MCP server for filesystem operations, based on Anthropic's reference implementation. It provides file and directory tools, with JSON output for metadata and directory trees and gitignore-style exclusions in searches.
Key features
- 01Create, move, and edit files
- 02Read one or multiple files
- 03List directories and allowed paths
- 04Return directory trees as JSON
- 05Return file metadata as JSON
- 06Search with gitignore-style exclusions
Use cases
- 01Inspect directory contents and metadata
- 02Read or update files through MCP
- 03Find files while excluding matched paths
MCP support
Exposes filesystem operations as tools for MCP clients, including reading, writing, editing, moving, listing, and searching files and directories.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMEFilesystem MCP Server
This is a Go implementation of the Model Context Protocol (MCP) server for filesystem operations, based on Anthropic's reference implementation from modelcontextprotocol/servers.
Significant differences from the reference implementation include:
- The
get_file_infoanddirectory_treecommands return JSON data. - The
search_filestool supports gitignore-style exclude patterns.
Installation
Install the server with the following command:
go install github.com/optistar/mcp-server-filesystem/cmd/mcp-server-filesystem@latest
The executable will be installed in the Go bin directory, which is typically ~/go/bin.
If this directory is not in your PATH, you may need to add it.
You can also set the GOBIN environment variable to change the installation directory.
Testing
A full test suite is included to ensure the server behaves as expected.
- The tests can be run normally with
go test. - A
testercommand packages the test suite as an MCP client that can be used to test the MCP server command, or another MCP server implementation.
Tools
The server provides the following tools for interacting with the filesystem:
create_directory: Create a new directory or ensure a directory exists.directory_tree: Get a recursive tree view of files and directories as a JSON structure.edit_file: Make line-based edits to a text file.get_file_info: Retrieve detailed metadata about a file or directory.list_allowed_directories: Returns the list of directories that this server is allowed to access.list_directory: Get a detailed listing of all files and directories in a specified path.move_file: Move or rename files and directories.read_file: Read the complete contents of a file from the file system.read_multiple_files: Read the contents of multiple files simultaneously.search_files: Recursively search for files and directories matching a pattern.write_file: Create a new file or completely overwrite an existing file with new content.
Use the inspector for full details on each tool.
Other implementations
This repository is unrelated to mark3labs/mcp-filesystem-server.
License
The code in this repository is distributed under the MIT License.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.