MCP.so
Sign In

Filesystem MCP Server

@optistar

Repository

About Filesystem MCP Server

No overview available yet

Basic information

Category

Files & Storage

License

MIT

Runtime

go

Transports

stdio

Publisher

optistar

Config

No standard config provided

This server doesn't expose a parseable MCP config block in its README. See the repository for install instructions.

Repository

Tools

11

Create a new directory or ensure a directory exists.

Get a recursive tree view of files and directories as a JSON structure.

Make line-based edits to a text file.

Retrieve detailed metadata about a file or directory.

Returns the list of directories that this server is allowed to access.

Get a detailed listing of all files and directories in a specified path.

Move or rename files and directories.

Read the complete contents of a file from the file system.

Read the contents of multiple files simultaneously.

Recursively search for files and directories matching a pattern.

Create a new file or completely overwrite an existing file with new content.

Overview

What is Filesystem MCP Server?

Filesystem MCP Server is a Go implementation of the Model Context Protocol (MCP) server that provides filesystem operations, based on Anthropic's reference implementation. It is intended for use with MCP-compatible clients to perform file and directory operations.

How to use Filesystem MCP Server?

Install via go install github.com/optistar/mcp-server-filesystem/cmd/mcp-server-filesystem@latest. The executable will be placed in the Go bin directory (typically ~/go/bin). Run the server and connect it to an MCP client; tools are invoked by the client.

Key features of Filesystem MCP Server

  • Create, read, write, edit, and move files and directories.
  • Retrieve detailed file metadata as JSON.
  • Recursive directory tree view as JSON.
  • Search files with gitignore-style exclude patterns.
  • Read multiple files simultaneously.
  • Full test suite included.

Use cases of Filesystem MCP Server

  • Allow an LLM to browse and edit local files on a user’s machine.
  • Automate file organization tasks through MCP clients.
  • Provide structured file access in development workflows.
  • Enable AI agents to manage project file structures.

FAQ from Filesystem MCP Server

How does this server differ from the reference implementation?

The get_file_info and directory_tree commands return JSON data, and the search_files tool supports gitignore‑style exclude patterns.

What are the runtime requirements?

It is distributed as a Go binary; no special runtime beyond the compiled executable is required.

How can I test the server?

Run go test for the test suite, or use the included tester command which acts as an MCP client to test the server.

Is this related to other filesystem MCP implementations?

No, this repository is unrelated to mark3labs/mcp-filesystem-server.

How can I see all tool details?

Use the MCP inspector for full documentation on each tool.

Comments

More Files & Storage MCP servers

Mcp Google Sheets

xing5

This MCP server integrates with your Google Drive and Google Sheets, to enable creating and modifying spreadsheets.

934

Sample S3 Model Context Protocol Server

aws-samples

78

Storacha MCP Storage Server

storacha

Storacha MCP storage server - self-sovereign data for your AI applications.

13

PDF Extraction MCP Server (Claude Code Fork)

xraywu

MCP server to extract contents from a PDF file

31

WORK IN PROGRESS - USE WITH CAUTION - Windows:

hanweg

MCP server for working with PDF files

74