MCP Filesystem logo

MCP Filesystem

by isaacphi

The MCP Filesystem is a Model Context Protocol (MCP) server that exposes resources for each file in a working directory and sends change notifications. It allows clients to access and monitor files within a specified workspace as MCP resources.

View on GitHub

Last updated: N/A

What is MCP Filesystem?

The MCP Filesystem is a server that presents files in a directory as MCP resources, enabling clients to access and monitor file changes.

How to use MCP Filesystem?

Install the server using go install github.com/isaacphi/mcp-filesystem@latest. Configure your MCP client (e.g., Claude Desktop) to use the server by specifying the command and workspace path in the client's configuration file.

Key features of MCP Filesystem

  • Resources for each file

  • Gitignore support

  • Change notifications

  • MIME type detection and encoding handling

Use cases of MCP Filesystem

  • Integrating file system access into MCP-based applications

  • Monitoring file changes in a workspace

  • Providing file content to AI models or other tools

  • Enabling resource-based access to files

FAQ from MCP Filesystem

What is MCP?

MCP stands for Model Context Protocol. It's a protocol for communication between applications and services, often used in AI and development environments.

How do I specify the workspace?

Use the --workspace argument when configuring the server in your client's configuration file. Provide the absolute path to your project directory.

Does it support .gitignore?

Yes, the server respects .gitignore rules, preventing ignored files from being exposed as resources.

How do I enable debug logging?

Set the DEBUG environment variable to 1 in your client's configuration for the server.

What clients are supported?

The server is designed to work with any client that supports MCP features like resource listing, change notifications, and resource content access. Claude Desktop is specifically mentioned in the documentation.