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.
Claude Desktop Config and [mcp-cli](https://github.com/chrishayuk/mcp-cli)
Add this to your
claude_desktop_config.json or server_config.json file: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.):
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
jbanginstalled 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:
Example:
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. 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.
Claude Desktop Config and [mcp-cli](https://github.com/chrishayuk/mcp-cli)
Add this to your
claude_desktop_config.json or server_config.json file: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.):
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
jbanginstalled 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:
Example:
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.