# Filesystem MCP

Filesystem MCP is a self-hosted ai app. Filesystem MCP server, bridged over HTTP with supergateway (baked into the image) so any MCP client that speaks HTTP/SSE can use it. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/2573/filesystem-mcp

## Description

Filesystem MCP server, bridged over HTTP with supergateway (baked into the image) so any MCP client that speaks HTTP/SSE can use it. Exposes whatever directory you mount, read-write by default - mount read-only (:ro) if you only want it browsing/reading.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

36/100 (Low), based on 4 of 4 factors.
- Maintained: 69 (last commit 65 days ago)
- Popular: 0 (0 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Light to run: 10 (16 GB minimum RAM)

## Links

- Docker Hub: https://hub.docker.com/r/louij2/filesystem-mcp
- GitHub: https://github.com/louij2/filesystem-mcp
- Unraid: https://ca.unraid.net/apps/filesystem-mcp-05a377716hyjb3?q=filesystem-mcp

## Common questions

### Do I need to build the base docker-mcp image before building filesystem-mcp?

If you are rebuilding the image family from scratch, build louij2/docker-mcp first. filesystem-mcp is built FROM louij2/docker-mcp:latest, so you can also pull the base image instead.

### What package must be present before starting filesystem-mcp?

Install fsspec before starting filesystem-mcp. It supplies the code that opens folders and files, and without it the app cannot access or cache files.

### How do I choose between read-only and read-write file access?

Mount the directory tree you want exposed as read-only or read-write and point the server at it. The upstream package README documents the CLI args.

### How does the container expose the filesystem MCP server to clients?

The image uses the shared stdio-to-HTTP bridge pattern from docker-mcp. The docker-mcp README documents that pattern.

---
Source: Our Local Host (https://ourlocalhost.com/app/2573/filesystem-mcp), the self-hosted and open-source app directory.
