Filesystem SSE Server in Go

What is Filesystem SSE Server in Go?

Filesystem SSE Server in Go is an MCP server that provides tools to interact with the local file system—such as listing directory entries, reading/writing files, retrieving file info, renaming, and copying files or directories. It runs an SSE server on a local machine and is intended for developers who need file system operations through the Model Context Protocol.

How to use Filesystem SSE Server in Go?

Install using go install github.com/lealre/fs-mcp@latest (Go 1.24 required), then start the server with fs-mcp -dir /your/directory/path. The server listens on http://localhost:8080 (or a custom port via -port flag) and exposes an SSE endpoint at /sse. You can then connect any MCP client (e.g., a PydanticAI agent) to this endpoint.

Key features of Filesystem SSE Server in Go

• List directory entries with configurable depth.
• Read file contents from a given path.
• Create or overwrite files with specified content.
• Retrieve file info (size, modified time, MIME type, permissions).
• Rename files or directories.
• Copy files or directories to a new location.

Use cases of Filesystem SSE Server in Go

• Have an AI agent browse and list files in a local directory.
• Allow an agent to read configuration or log files.
• Let an agent write output files to a controlled directory.
• Enable an agent to restructure local folders (rename, copy).

FAQ from Filesystem SSE Server in Go

What dependencies are required?

Go version 1.24 must be installed on your system.

What transport does the server use?

It uses SSE (Server-Sent Events) over HTTP. The MCP endpoint is at http://localhost:8080/sse.

Can I restrict which directories are accessible?

Yes, the -dir flag is required and specifies the base directory. All file operations are restricted to paths under that directory. Only one directory path is accepted.

Does the server require authentication?

The README does not mention any authentication mechanism.

Are there any known limits?

The server currently accepts only a single base directory path (via the -dir flag). File operations outside this directory are not permitted.