Filesystem Access MCP Server

File SystemsJava

Access and manipulate files on your local filesystem

Available Tools

listFiles

List files and directories in a specified path

readFile

Read the contents of a file

writeFile

Write or modify the contents of a file

The Filesystem MCP server enables AI assistants to list, read, and modify files directly from your computer's filesystem. Built on Quarkus, this server provides a secure way to grant AI models access to specific directories you choose, allowing them to work with your local files while maintaining control over which locations are accessible.

Overview

The Filesystem MCP server provides AI assistants with the ability to interact with your local filesystem. This enables AI models to help you with tasks like code editing, file organization, and document analysis by giving them direct access to files in directories you specify.

Installation

There are two main ways to install and run the Filesystem MCP server:

Option 1: Using JBang (Recommended for most users)

Install JBang if you don't have it already
Configure your MCP client (Claude Desktop, mcp-cli, etc.) to use the server

Option 2: Using Native Executables

For faster startup times, you can download pre-built native executables:

Download the appropriate executable for your platform from the releases page
Configure your MCP client to use the downloaded executable

Configuration

When configuring your MCP client, you'll need to specify which directories you want to make accessible to the AI. This is done by providing paths as arguments to the server.

For example, to give access to your code directory and documents folder, you would configure the server with those paths as arguments.

Troubleshooting

If you encounter issues:

Ensure JBang is properly installed and in your PATH
If JBang isn't found, use the full path to the JBang executable

Enable detailed logging by adding these parameters:

-Dquarkus.log.file.enable=true -Dquarkus.log.file.path=${user.home}/mcp-server-filesystem.log

Security Considerations

Only directories explicitly specified as arguments will be accessible to the AI. Be mindful about which directories you expose, especially those containing sensitive information.