quarkus-mcp-server-example

What is quarkus-mcp-server-example?

A Quarkus-based example MCP server that exposes tools to interact with a REST API, enabling AI agents to create and manage application records through natural language.

How to use quarkus-mcp-server-example?

Build the project with Maven, start a PostgreSQL database in Podman, run the dependent microservice, create a sample application via curl, then launch the MCP server with Goose using goose session --with-extension="java -jar ...".

Key features of quarkus-mcp-server-example

• Built on Quarkus framework
• Integrates with a REST API via MCP Tools
• Uses PostgreSQL for data storage
• Runs as a Java JAR extension for Goose
• Demonstrates MCP server creation in Quarkus

Use cases of quarkus-mcp-server-example

• Learning to build MCP servers with Quarkus
• Allowing AI agents to submit applications to a REST API
• Prototyping tool-driven interactions with backend services

FAQ from quarkus-mcp-server-example

What are the required dependencies?

Maven, Podman, Java 21, and Goose.

How do I start the database?

Run podman run -d --name db-server -e POSTGRES_USER=test -e POSTGRES_PASSWORD=test -e POSTGRES_DB=applications -p 5432:5432 postgres:16.

How do I run the MCP server?

After building, use goose session --with-extension="java -jar quarkus-mcp-server/target/quarkus-mcp-server-1.0.0-SNAPSHOT.jar".

What does the server do?

It provides tools that let an AI agent interact with a REST API, for example to create new applications.

—

Does the server use authentication?

—

Are there any known limitations?

—