quarkus-mcp-servers

by quarkiverse

Integrations

  • Provides access to the local file system, enabling listing, reading, and modifying files in user-specified directories.

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

  1. Install jbang
  2. 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_config.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.

-
security - not tested
A
license - permissive license
-
quality - not tested

local-only server

The server can only run on the client's local machine because it depends on local resources.

browse, list and edit filesystem. Implemented in Java/Quarkus with native image (Fast!) available

  1. General Usage
    1. Claude Desktop Config and mcp-cli
      1. Native Image/Executable
        1. Troubleshooting
        2. How was this made?

      Related MCP Servers

      • -
        security
        A
        license
        -
        quality
        This server provides: * Fast file search capabilities using Everything SDK * Windows-specific implementation * Complements existing filesystem servers with specialized search functionality
        Last updated -
        57
        Python
        MIT License
      • -
        security
        A
        license
        -
        quality
        This server offers secure, read-only access to directory files via the MCP, supporting file searching, .gitignore compliance, path traversal protection, and MIME type detection using the 'file://' URI scheme.
        Last updated -
        6
        MIT License
        • Apple
        • Linux
      • -
        security
        F
        license
        -
        quality
        This server provides an interface for performing basic file system operations such as navigation, reading, writing, and file analysis, allowing users to manage directories and files efficiently.
        Last updated -
        3
        Python
      • A
        security
        A
        license
        A
        quality
        An MCP server that provides tools for reading, writing, and editing files on the local filesystem.
        Last updated -
        1
        1,241
        Python
        Apache 2.0
        • Apple

      View all related MCP servers

      ID: x4x44pbgs3