Quarkiverse Quarkus MCP Servers

This project provides a series of Model Context Protocol (MCP) server implementations based on the Quarkus framework, used to extend the capabilities of large language model (LLM) applications that support MCP. It includes various services such as JDBC databases, file systems, JavaFX drawing, Kubernetes, and containers.

Developer tools Database #MCP Services #Quarkus Framework #LLM Extension #Java Development .Java

rating : 2 points

downloads : 7.3K

update time : 2025-04-28

Open Site

What is Model Context Protocol (MCP)?

MCP is a protocol that allows users to interact with various external systems through language models (such as AI assistants). These servers offer a wealth of features, enabling you to easily integrate databases, file systems, graphical interfaces, etc.

How to use MCP servers?

Simply run the corresponding server script to quickly enable specific features. For example, you can connect to a database via the JDBC server or access local files via the file system server.

Applicable Scenarios

MCP servers are suitable for application scenarios that require enhanced AI capabilities, such as data analysis, automated office work, and creative generation.

Main Features

JDBC Server

Supports connecting to relational databases via JDBC for easy data storage and retrieval.

File System Server

Allows users to browse and operate the local file system through the MCP interface.

JavaFX Drawing Server

Provides a JavaFX-based canvas function for drawing graphics and visualization.

Kubernetes Server

Supports managing Kubernetes clusters through MCP.

Container Server

Allows users to manage and operate Docker/Podman containers.

Advantages

Easy to use and can be quickly deployed without complex configuration.

Supports multiple programming languages and operating systems.

Highly scalable, allowing new features to be added as needed.

Limitations

Some advanced features may require additional learning costs.

Depends on the support of the underlying system environment.

How to Use

Install JBang

Ensure that the JBang tool is installed for running MCP servers.

Select the Required Server

Choose the appropriate MCP server according to your needs, such as the JDBC or file system server.

Start the Server

Run the server script to start the service.

Usage Examples

Example 1: Query the Database

Use the JDBC server to retrieve data from a PostgreSQL database.

Example 2: Upload a File

Use the file system server to upload a file to a remote server.

Frequently Asked Questions

What is MCP?

How to start an MCP server?

Are there other MCP servers available?

Related Resources

MCP Official Website

Learn about the MCP protocol and its applications.

Quarkus MCP Server Repository

Source code and documentation on GitHub.

JBang Tool Official Website

The official page of the JBang tool.

🚀 Implementing Model Context Protocol Servers in Quarkus/Java

This project includes an implementation of the Model Context Protocol servers, written using the Quarkus MCP Server Framework.

These servers allow you to extend the functionality of large language model (LLM) AI applications that support MCP.

They can also be used in LLM applications that support MCP, such as Claude Desktop. You can find other clients on the Awesome MCP Clients page.

🚀 Quick Start

🚀 Running the Servers

All of these servers can be run using jbang everywhere: Java, JavaScript, Python, etc. Where jbang is mentioned, you can replace it with npx @jbangdev/jbang or uvx jbang or pipx jbang, depending on your preference.

📦 Servers

jdbc

The jdbc server can be used to store and retrieve data in a database using only a JDBC URL. You can use any JDBC database, such as Postgres, MySQL, Oracle, Sqlite, etc.

jbang jdbc@quarkiverse/quarkus-mcp-servers

For more information, refer to the jdbc documentation.

filesystem

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

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

For more information, refer to the filesystem documentation.

jfx

The jfx server exposes a canvas that can be used for drawing with JavaFX.

jbang jfx@quarkiverse/quarkus-mcp-servers

For more information, refer to the jfx documentation.

kubernetes

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

jbang kubernetes@quarkiverse/quarkus-mcp-servers

containers

The containers server allows you to work with Docker/Podman/OCI-compatible container runtimes.

jbang containers@quarkiverse/quarkus-mcp-servers

📚 Other Quarkus MCP-based Servers

WildFly

A WildFly MCP server that allows interaction with a running WildFly. You can watch this WildFly video to understand its capabilities. For more information, refer to the WildFly MCP server documentation.

💡 Ideas for Other Servers

If you have ideas for other servers, you are welcome to contribute to this project. If you're short on ideas, consider the following possible contributions:

Develop documentation for the Model Context Protocol.
Implement new features in LLM applications that support MCP.
Contribute to languages or frameworks that support MCP.

🔧 How to Contribute

To contribute to the project, follow these steps:

Clone the repository You can clone the repository here and find all relevant Quarkus MCP servers.
Build the modules Build each module using Maven or Gradle. For example, for quarkus-mcp-jdbc:
```
mvn clean install
```
Add a new project If you want to create a new project for a protocol or feature, follow these steps:
- Import dependencies from an existing Quarkus MCP server (e.g., quarkus-mcp-core).
- Create a new repository on GitHub and include all necessary files, such as pom.xml or build.gradle.
Submit your code You can contribute your changes by submitting a pull request to GitHub. Make sure to add detailed commit messages and documentation.
Share your ideas If you have new ideas for a feature or protocol, create an issue or discussion in the project's GitHub repository to communicate with the maintainers.