Model Context Protocol Servers In Quarkus

What is Model Context Protocol Servers In Quarkus about?

A set of ready‑to‑run MCP servers implemented in Java using the Quarkus framework. Each server exposes a specific capability—such as JDBC database operations, JVM process inspection, file system exposure, JavaFX drawing canvas, Kubernetes cluster interaction, container engine control, or Wolfram Alpha web‑search—through the Model Context Protocol so LLM‑powered applications can invoke them directly.

How to use Model Context Protocol Servers In Quarkus?

1. Clone and build

   git clone https://github.com/quarkiverse/quarkus-mcp-servers
   cd quarkus-mcp-servers
   mvn clean install
   

2. Run a server with JBang (or the equivalent npx if an npm wrapper exists). Example for the JDBC server:

   jbang jdbc@quarkiverse/quarkus-mcp-servers
   

   Replace jdbc with any of jvminsight, filesystem, jfx, kubernetes, containers, or wolfram to start the corresponding service. For the filesystem server you can pass one or more directory paths as arguments:

   jbang filesystem@quarkiverse/quarkus-mcp-servers /data /var/log
   

3. Integrate with an LLM that supports MCP (e.g., Claude Desktop) and invoke the desired server by its name.

Key Features of Model Context Protocol Servers In Quarkus

• JDBC server – Connect to any JDBC‑compatible database (Postgres, MySQL, SQLite, etc.) for CRUD operations.
• JVM Insight server – Inspect running JVM processes, retrieve thread dumps, heap information, and JFR data.
• Filesystem server – Expose files and directories over MCP, allowing LLMs to read/write files.
• JavaFX (JFX) server – Provide a canvas for drawing or visual interaction via JavaFX.
• Kubernetes server – Perform CRUD actions on Kubernetes resources (pods, services, deployments, etc.).
• Containers server – Manage Docker/Podman/OCI containers: list, start, stop, pull images, etc.
• Wolfram server – Execute Wolfram Alpha LLM‑optimized web searches.
• Single‑command deployment – All servers are runnable with a single JBang command, no extra setup required.
• Modular architecture – New servers can be scaffolded with jbang init -t mcp <name> and added to the multi‑module Maven build.

Use Cases

• LLM‑augmented data pipelines – Use the JDBC server to fetch or store data directly from an LLM‑driven workflow.
• Debugging assistance – Enable an LLM to diagnose JVM issues by querying the JVM Insight server.
• File manipulation – Allow AI agents to read, edit, or generate project files via the Filesystem server.
• Interactive visualisation – Let an LLM create drawings or diagrams in real time using the JavaFX canvas.
• Cloud/cluster automation – Automate Kubernetes deployments or container lifecycle management from within an LLM prompt.
• Knowledge enrichment – Retrieve up‑to‑date facts through Wolfram Alpha searches tailored for LLM consumption.

FAQ

Q: Do I need Docker or a specific JDK to run these servers? A: A Java 17+ runtime is sufficient. Docker is only required for the containers server if you intend to manage Docker/Podman resources.

Q: Can I run multiple servers simultaneously? A: Yes. Each server listens on its own port (configured by Quarkus defaults). Start each with its own JBang command.

Q: How are authentication tokens handled? A: Servers inherit any environment variables you set before launching them (e.g., WOLFRAM_APP_ID for the Wolfram server). Configure them in your shell or CI environment.

Q: How do I add a new server? A: Use the scaffolding command jbang init -t mcp <new-server-name>, implement the desired logic, add <module><new-server-name></module> to the root pom.xml, then mvn clean install.

Q: Is there a GUI for monitoring these servers? A: Quarkus provides a dev UI on http://localhost:<port>/q/dev. You can also enable Micrometer metrics for external dashboards.

Model Context Protocol Servers in Quarkus/Java

This project contains Model Context Protocol servers, implemented in Java using the Quarkus MCP server framework.

These lets you extend the capabilities of your MCP enabled LLM (Large Language Model) AI applications.

These also work in MCP enabled LLM applications, like Claude Desktop. You can find other clients on Awesome MCP Clients page.

Running the servers

All of these servers are available to run with jbang everywhere: Java, JavaScript, Python and more. Where it says jbang it can be replaced with npx @jbangdev/jbang or uvx jbang or pipx jbang dependent on your preference.

Servers

jdbc

The jdbc server can be used to store and retrieve data from a database given just a JDBC URL. You can use any JDBC database, like Postgres, MySQL, Oracle, Sqlite, etc.

jbang jdbc@quarkiverse/quarkus-mcp-servers

See more in the jdbc readme.

jvminsight

The jvminsight server is a server that can be used to inspect a running JVM process.

jbang jvminsight@quarkiverse/quarkus-mcp-servers

See more in the jvminsight readme.

filesystem

The filesystem server is a file system server that can be used to serve files from a file system.

jbang filesystem@quarkiverse/quarkus-mcp-servers [path1] [path2] ...

See more in the filesystem readme.

jfx

The jfx server exposes a canvas that can be used to make drawings using JavaFX.

jbang jfx@quarkiverse/quarkus-mcp-servers

See more in the jfx readme.

kubernetes

The kubernetes server can be used to interact with a Kubernetes cluster.

jbang kubernetes@quarkiverse/quarkus-mcp-servers

containers

The 'containers' server lets you work with Docker/Podman/OCI compatible container engines.

jbang containers@quarkiverse/quarkus-mcp-servers

wolfram

The wolfram server can be used to perform web search optimized for use by a large language model through the Wolfram Alpha LLM API.

jbang wolfram@quarkiverse/quarkus-mcp-servers

Other Quarkus MCP based servers

WildFly

A WildFly MCP server that allows you to interact with WildFly running servers.

You can check this WildFly vlog that demonstrates its capabilities.

Read more in the WildFly MCP Server readme.

Ideas for other servers

If you have ideas for other servers, feel free to contribute them to this project.

If missing ideas, then look at the reference servers at https://github.com/modelcontextprotocol/servers and see if you can implement them in this project.

Other ideas:

• zulip
• jfr/java hooked to jmx/jfr
• quarkus dev mode
• ...

Contributing

If you have ideas for other servers, feel free to contribute them to this project.

To get started, clone the repository and build it:

git clone https://github.com/quarkiverse/quarkus-mcp-servers
cd quarkus-mcp-servers
mvn clean install

Then run the following command to generate a new server for i.e. jfr:

mkdir jfr
cd jfr
jbang init -t mcp jfr

This will create the jfr directory with a Hello World MCP server.

You can then build it:

mvn clean install

To wire it into the full project you need to add <module>jfr</module> to the root pom.xml file.

Make sure you have added some useful content to the README.md file + updated the demo image.

Then open a PR :)