Model Context Protocol Server for filesystem

This Model Context Protocol(MCP) server enables Large Language Models (LLMs) to list, read and modify files from the filesystem.

General Usage

Install jbang
Configure your MCP Client to run the server (see Claude Desktop Config below)

Use the following command to start the server with access to specific paths.

jbang filesystem@quarkiverse/quarkus-mcp-servers ~/code/quarkiverse ~/code/jbang 

Claude Desktop Config and mcp-cli

Add this to your claude_desktop.json or server_config.json file:

{
  "mcpServers": {
    "filesystem": {
      "command": "jbang",
      "args": [
        "filesystem@quarkiverse/quarkus-mcp-servers",
        "[path1]",
        "[path2]"
      ]
    }
  }
}

Native Image/Executable

Using native image, the startup time is almost instant.

You can download the native images from the release page.

Then use the executable for your platform in your MCP client.

Example for MacOS arm64 (M1, M2, etc.):

{
  "mcpServers": {
    "filesystem": {
      "command": "jbang",
      "args": [
        "mcp-server-filesystem-osx-aarch_64",
        "[path1]",
        "[path2]"
      ]
    }
  }
}

You can of course also rename the executable to something else, like mcp-server-filesystem if you want.

Troubleshooting

jbang not found

Make sure you have jbang installed and available in your PATH
Alternatively, use full path to jbang executable (e.g. /Users/username/.jbang/jbang)

Get more logging

To get more detailed logging you can add the following parameters to the jbang command line:

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

Example:

jbang -Dquarkus.log.file.enable=true -Dquarkus.log.file.path=${user.home}/mcp-server-filesystem.log filesystem@quarkiverse/quarkus-mcp-servers [path1] [path2] ...

How was this made?

The MCP server uses Quarkus, the Supersonic Subatomic Java Framework and its Model Context Protocol support.

If you want to learn more about Quarkus MCP Server support, please see this blog post and the Quarkus MCP Server extension documentation.

To launch the server it uses jbang to setup Java and run the .jar as transparent as possible. Very similar to how uvx, pipx, npmx and others works; just for Java.