Quarkus
This extension enables developers to implement the MCP server features easily.
What is Quarkus?
Quarkus is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to this extension enables developers to implement the mcp server features easily.
This extension enables developers to implement the MCP server features easily.
This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- This extension enables developers to implement the MCP serve
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx quarkusConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Quarkus
The Quarkus MCP Server extension is a Java library that lets developers add Model Context Protocol server capabilities to any Quarkus application by annotating CDI bean methods with @Tool, @Prompt, and @Resource. It supports both STDIO and HTTP transports, making it straightforward to expose existing Java business logic, file resources, and prompt templates to AI agents without writing protocol-level code. Java developers building enterprise or cloud-native applications use this extension to rapidly integrate MCP server functionality into their existing Quarkus services, leveraging Quarkus's native compilation and fast startup for production deployments.
Prerequisites
- Java 17+ JDK
- Apache Maven 3.9+ or Gradle
- An existing Quarkus project (or use the Quarkus CLI to create one)
- An MCP-compatible client such as Claude Desktop to test the server
Add the Quarkus MCP Server dependency to your project
Choose the transport artifact matching your deployment: `quarkus-mcp-server-stdio` for subprocess-style communication or `quarkus-mcp-server-http` for HTTP/SSE streaming.
<dependency>
<groupId>io.quarkiverse.mcp</groupId>
<artifactId>quarkus-mcp-server-stdio</artifactId>
<version>${quarkus-mcp-server-version}</version>
</dependency>Annotate a CDI bean method as an MCP Tool
Add @Tool to any CDI bean method to expose it as a callable tool. The extension automatically registers the annotated class as a @Singleton CDI bean.
import io.quarkiverse.mcp.server.Tool;
import jakarta.inject.Singleton;
@Singleton
public class TextTools {
@Tool(description = "Convert text to lowercase")
public String toLowerCase(String text) {
return text.toLowerCase();
}
}Add an MCP Prompt
Annotate a method with @Prompt to register a named prompt template that clients can invoke with optional arguments.
import io.quarkiverse.mcp.server.Prompt;
import io.quarkiverse.mcp.server.PromptArg;
import io.quarkiverse.mcp.server.PromptMessage;
@Prompt(description = "Generate a code review prompt")
public PromptMessage codeAssist(@PromptArg(description = "Programming language") String lang) {
return PromptMessage.withUserRole("Review the following " + lang + " code:");
}Expose a file as an MCP Resource
Use @Resource with a URI to serve static or dynamic file content to connected AI agents.
import io.quarkiverse.mcp.server.Resource;
@Resource(uri = "file:///project/config.yaml", description = "Application configuration")
public byte[] configFile() throws Exception {
return getClass().getResourceAsStream("/config.yaml").readAllBytes();
}Configure Claude Desktop to launch the server
Build your Quarkus application as a JAR and configure Claude Desktop to spawn it as an MCP server subprocess using the stdio transport.
{
"mcpServers": {
"quarkus-server": {
"command": "java",
"args": ["-jar", "/path/to/your-app-runner.jar"]
}
}
}Quarkus Examples
Client configuration
Claude Desktop config for a Quarkus MCP server built as a runnable JAR with stdio transport
{
"mcpServers": {
"quarkus-server": {
"command": "java",
"args": ["-jar", "/path/to/my-quarkus-app-runner.jar"]
}
}
}Prompts to try
Example prompts to exercise tools and resources exposed via the Quarkus MCP extension
- "Convert the text 'Hello World' to lowercase using the text tools"
- "Generate a code review prompt for a Java function"
- "Read the application configuration file resource"
- "List all available tools and prompts on this server"Troubleshooting Quarkus
CDI bean methods annotated with @Tool are not appearing as tools
Ensure the class is either annotated with a CDI scope (@Singleton, @ApplicationScoped) or that Quarkus discovers it automatically. The extension registers the bean as @Singleton if no scope is present, but confirm the class is in a scanned package.
Server exits immediately when launched by Claude Desktop
The stdio transport requires the server to read from stdin. Verify you added the `quarkus-mcp-server-stdio` artifact, not the HTTP one. Check application logs in the Quarkus output for startup errors.
Build fails with 'quarkus-mcp-server version not found'
Check the latest version in the Quarkus extension registry at code.quarkus.io or on Maven Central for `io.quarkiverse.mcp:quarkus-mcp-server-stdio`. Set the correct version in your `${quarkus-mcp-server-version}` property.
Frequently Asked Questions about Quarkus
What is Quarkus?
Quarkus is a Model Context Protocol (MCP) server that this extension enables developers to implement the mcp server features easily. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Quarkus?
Follow the installation instructions on the Quarkus GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Quarkus?
Quarkus works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Quarkus free to use?
Yes, Quarkus is open source and available under the Apache-2.0 license. You can use it freely in both personal and commercial projects.
Quarkus Alternatives — Similar Developer Tools Servers
Looking for alternatives to Quarkus? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.
Ecc
★ 188.2kThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Javaguide
★ 155.8kJava 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发
Gemini CLI
★ 104.5kA secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in
Awesome MCP Servers
★ 87.3k⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.
MCP Servers
★ 86.0kModel Context Protocol Servers
CC Switch
★ 77.5kA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
Browse More Developer Tools MCP Servers
Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Quarkus in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Quarkus?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.