MCP Filesystem

@isaacphi

Repository

Basic information

About MCP Filesystem

Model Context Protocol (MCP) server with a resource for each file in a workspace

MCP Filesystem 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

MCP Filesystem tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is MCP Filesystem?

MCP Filesystem is an MCP server that exposes each non‑ignored file in a workspace directory as a resource and sends real‑time change notifications. It is intended for developers using MCP‑compatible clients (e.g. Claude Desktop) who want AI assistants to access and interact with local project files.

How to use MCP Filesystem?

Install the server binary via go install github.com/isaacphi/mcp-filesystem@latest. Add it to your client’s MCP server configuration (e.g. claude_desktop_config.json) with the command mcp-filesystem and the --workspace argument set to the absolute path of your repository. The client must support resource listing, change notifications, and resource content access.

Key features of MCP Filesystem

Exposes each workspace file as an MCP resource
Respects .gitignore rules automatically
Detects file changes, additions, and deletions
Identifies MIME types and handles text encodings
Written in Go, installable via go install

Use cases of MCP Filesystem

AI assistants can read and reference all non‑ignored files in a project
Collaborative code review with real‑time file change awareness
Automating documentation generation from live file contents
Providing context‑aware code suggestions based on workspace state

Frequently asked questions

What runtime or dependencies are required?

Go must be installed to build or install the server; the final server is a standalone Go binary.

Does it support .gitignore patterns?

Yes, the server respects `.gitignore` rules and ignores matched files.

How does the server detect file changes?

It uses the fsnotify library to monitor file system events and sends `notifications/resources/list_changed` notifications to the client.

What MIME type handling does it support?

It identifies file types and handles various text encodings for each registered resource.

Is this production‑ready?

No, the server is pre‑beta quality. Issues and feedback are welcome.

Comments

More Files & Storage MCP servers

S3 MCP Server

samuraikun

MCP server to integrate AWS S3 and LLM

PDF Reader MCP Server (@shtse8/pdf-reader-mcp)

shtse8

📄 The PDF intelligence layer for AI agents — Agent Document Twin, evidence-first extraction, visual crops, OCR provenance, trust reports, and benchmark-gated releases. MCP server for Claude, Cursor, VS Code, and any MCP client.

810

File Context Server

bsmi021

A Model Context Protocol (MCP) server that provides file system context to Large Language Models (LLMs). This server enables LLMs to read, search, and analyze code files with advanced caching and real-time file watching capabilities.

Rust MCP Filesystem

rust-mcp-stack

Blazing-fast, asynchronous MCP server for seamless filesystem operations.

163

Filesystem

modelcontextprotocol

Model Context Protocol Servers

88.1K