drio
Open app

Quarkus + MCP = Agentic

Source

This project uses Quarkus and the Model Context Protocol] to implement a simple agentic app using multiple MCP servers and Quarkus + LangChain4j.

Catalog onlyCatalog onlySTDIO

Overview

Quarkus MCP Agentic is a project that utilizes the Quarkus framework and the Model Context Protocol to create a simple agentic application that interacts with multiple MCP servers.

To use the application, you need to set up the required environment by installing Node.js and npm, create a directory for the MCP server, and configure API keys for various services. You can run the application in development mode using Maven commands.

  • Integration with multiple MCP servers. - Support for LangChain4j for enhanced functionality. - Ability to run in development mode with live coding features.
  1. Building agentic applications that require interaction with multiple APIs.
  2. Developing chatbots or conversational agents using the Model Context Protocol.
  3. Creating applications that leverage AI services like OpenAI and Google Maps.

Add to your AI client

Use these steps to connect Quarkus + MCP = Agentic in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "quarkus-mcp-agentic-jamesfalkner": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-quarkus-mcp-agentic-jamesfalkner"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "quarkus-mcp-agentic-jamesfalkner": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-quarkus-mcp-agentic-jamesfalkner"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "quarkus-mcp-agentic-jamesfalkner": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-quarkus-mcp-agentic-jamesfalkner"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "quarkus-mcp-agentic-jamesfalkner": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-quarkus-mcp-agentic-jamesfalkner"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "quarkus-mcp-agentic-jamesfalkner": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-quarkus-mcp-agentic-jamesfalkner"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "quarkus-mcp-agentic-jamesfalkner": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-quarkus-mcp-agentic-jamesfalkner"
      ]
    }
  }
}

FAQ

What is the Model Context Protocol?

The Model Context Protocol is a framework that allows for the integration of various services and APIs in a cohesive manner.

Is there a guide for setting up the project?

Yes! The project includes detailed instructions for setup and configuration in the README file.

Can I run this application in production?

Yes, but ensure to handle API keys and sensitive information securely.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":1528,"uuid":"637dea38-6e0c-441a-8884-3cc7b1b6f81d","name":"quarkus-mcp-agentic","title":"Quarkus + MCP = Agentic","description":"This project uses Quarkus and the Model Context Protocol] to implement a simple agentic app using multiple MCP servers and Quarkus + LangChain4j.","avatar_url":"https://avatars.githubusercontent.com/u/861894?v=4","created_at":"2025-02-20T16:15:08.691Z","updated_at":"2025-02-23T07:22:06.275Z","status":"created","author_name":"jamesfalkner","author_avatar_url":"https://avatars.githubusercontent.com/u/861894?v=4","tags":"[]","category":"research-and-data","is_featured":false,"sort":1,"url":"https://github.com/jamesfalkner/quarkus-mcp-agentic","target":"_self","content":"$29","summary":"$2a","img_url":"https://github.com/jamesfalkner/quarkus-mcp-agentic/raw/main/docs/landingpage.png","type":null,"metadata":"{\"star\":\"1\",\"license\":\"\",\"language\":\"HTML\",\"is_official\":false,\"latest_commit_time\":\"2025-04-03 12:03:22\"}","user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]

Research and data