Use standard Java naming conventions (PascalCase classes, camelCase methods)
Organize in packages: model, repository, service, mcp
Use Record types for immutable data models
State management for immutable data must be managed by repository layer
Add Javadoc for public methods
MCP Tools
Must be public methods in @ApplicationScoped CDI beans
Use @Tool(name="tool_name", description="clear description")
Never return null - return error messages instead
Always validate parameters and handle errors gracefully
Architecture
Separate concerns: MCP tools → Service layer → Repository
Use @Inject for dependency injection
Make data operations thread-safe
Use Optional<T> to avoid null pointer exceptions
Common Issues
Don't put business logic in MCP tools (use service layer)
Don't throw exceptions from tools (return error strings)
Don't forget to validate input parameters
Test with edge cases (null, empty inputs)
1---2name: quarkus-mcp-server-sse3description: Quarkus MCP Server4---5# Quarkus MCP Server67Build MCP servers with Java 21, Quarkus, and HTTP SSE transport.89## Stack1011- Java 21 with Quarkus Framework12- MCP Server Extension: `mcp-server-sse`13- CDI for dependency injection14- MCP Endpoint: `http://localhost:8080/mcp/sse`1516## Quick Start1718```bash19quarkus create app --no-code -x rest-client-jackson,qute,mcp-server-sse your-domain-mcp-server20```2122## Structure2324- Use standard Java naming conventions (PascalCase classes, camelCase methods)25- Organize in packages: `model`, `repository`, `service`, `mcp`26- Use Record types for immutable data models27- State management for immutable data must be managed by repository layer28- Add Javadoc for public methods2930## MCP Tools3132- Must be public methods in `@ApplicationScoped` CDI beans33- Use `@Tool(name="tool_name", description="clear description")`34- Never return `null` - return error messages instead35- Always validate parameters and handle errors gracefully3637## Architecture3839- Separate concerns: MCP tools → Service layer → Repository40- Use `@Inject` for dependency injection41- Make data operations thread-safe42- Use `Optional<T>` to avoid null pointer exceptions4344## Common Issues4546- Don't put business logic in MCP tools (use service layer)47- Don't throw exceptions from tools (return error strings)48- Don't forget to validate input parameters49- Test with edge cases (null, empty inputs)
Run npx skillmds@latest add diegosouzapw/quarkus-mcp-server-sse in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
Quarkus MCP Server It is listed under AI & ML on SkillMD.
This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
diegosouzapw (@diegosouzapw) published this skill. Their other Agent Skills are listed on their SkillMD profile.
diegosouzapw