Markdown Content: quarkus-mcp-servers/filesystem at main · quarkiverse/quarkus-mcp-servers · GitHub

===============

Skip to content Navigation Menu

Toggle navigation

Sign in

Appearance settings

• Product

*   [GitHub Copilot Write better code with AI](https://github.com/features/copilot)
*   [GitHub Spark New Build and deploy intelligent apps](https://github.com/features/spark)
*   [GitHub Models New Manage and compare prompts](https://github.com/features/models)
*   [GitHub Advanced Security Find and fix vulnerabilities](https://github.com/security/advanced-security)
*   [Actions Automate any workflow](https://github.com/features/actions)

*   [Codespaces Instant dev environments](https://github.com/features/codespaces)
*   [Issues Plan and track work](https://github.com/features/issues)
*   [Code Review Manage code changes](https://github.com/features/code-review)
*   [Discussions Collaborate outside of code](https://github.com/features/discussions)
*   [Code Search Find more, search less](https://github.com/features/code-search)

Explore * Why GitHub * All features * Documentation * GitHub Skills * Blog

• Solutions

By company size * Enterprises * Small and medium teams * Startups * Nonprofits

By use case * DevSecOps * DevOps * CI/CD * View all use cases

By industry * Healthcare * Financial services * Manufacturing * Government * View all industries

View all solutions

• Resources

Topics * AI * DevOps * Security * Software Development * View all

Explore * Learning Pathways * Events & Webinars * Ebooks & Whitepapers * Customer Stories * Partners * Executive Insights

• Open Source

*   [GitHub Sponsors Fund open source developers](https://github.com/sponsors)

*   [The ReadME Project GitHub community articles](https://github.com/readme)

Repositories * Topics * Trending * Collections

• Enterprise

*   [Enterprise platform AI-powered developer platform](https://github.com/enterprise)

Available add-ons * GitHub Advanced Security Enterprise-grade security features * Copilot for business Enterprise-grade AI features * Premium Support Enterprise-grade 24/7 support

• Pricing

Search or jump to...

Search code, repositories, users, issues, pull requests...

Search

Clear

Search syntax tips

Provide feedback

We read every piece of feedback, and take your input very seriously.

• [x] Include my email address so I can be contacted

Cancel Submit feedback

Saved searches

Use saved searches to filter your results more quickly

Name

Query

To see all available qualifiers, see our documentation.

Cancel Create saved search

Sign in

Sign up

Appearance settings

Resetting focus

You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert

{{ message }}

quarkiverse/**quarkus-mcp-servers**Public

• NotificationsYou must be signed in to change notification settings

• Fork 40

• Star 159

• Code

• Issues 16

• Pull requests 5

• Actions

• Models

• Security### Uh oh! There was an error while loading.Please reload this page.

• Insights

Additional navigation options

• Code
• Issues
• Pull requests
• Actions
• Models
• Security
• Insights

Collapse file tree

Files

main

Search this repository

•     .github  
  

•     .mvn  
  

•     containers  
  

•     filesystem  
  

  •      images  
    

  •      src/main  
    

  •    README.md  
    

  •    pom.xml  
    

•     jdbc  
  

•     jfx  
  

•     jvminsight  
  

•     kubernetes  
  

•     shared  
  

•     template  
  

•     wolfram  
  

•   .dockerignore  
  

•   .gitignore  
  

•   LICENSE  
  

•   README.md  
  

•   jbang-catalog.json  
  

•   jreleaser.yml  
  

•   mvnw  
  

•   mvnw.cmd  
  

•   pom.xml  
  

Breadcrumbs

1. quarkus-mcp-servers

/ filesystem

/

Copy path

Directory actions

More options

More options

Directory actions

More options

More options

Latest commit

quarkiverse-ci[bot]

[maven-release-plugin] prepare for next development iteration

success

May 22, 2025

bd561bc·May 22, 2025

History

History

Open commit details

Breadcrumbs

1. quarkus-mcp-servers

/ filesystem

/

Top

Folders and files

Name	Name	Last commit message	Last commit date
### parent directory ..
images	images	add images	Jan 25, 2025
src/main	src/main	Rename packages from io.quarkus.* to io.quarkiverse.* (#40)	Mar 26, 2025
README.md	README.md	fix: claude_desktop_config.json	Feb 24, 2025
pom.xml	pom.xml	[maven-release-plugin] prepare for next development iteration	May 22, 2025
View all files

README.md

Outline

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.

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

Claude Desktop Config and mcp-cli

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

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

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.):

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

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:

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

Example:

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

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.

Footer

© 2025 GitHub,Inc.

Footer navigation

• Terms
• Privacy
• Security
• Status
• Docs
• Contact
• Manage cookies
• Do not share my personal information

You can’t perform that action at this time.