A skill your agent uses when exposing Spring Boot 4 application capabilities through Model Context Protocol tools, resources, or prompts.

MITAuto-check passedBackend & APIs

Install MCP Server

skills CLI
$ npx skills add rrezartprebreza/spring-boot-skills --skill mcp-server -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install rrezartprebreza/spring-boot-skills mcp-server --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/rrezartprebreza/spring-boot-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/spring-boot-4/mcp-server .claude/skills/mcp-server && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
mcp-server
GitHub stars
301
Token cost
~1.3k tokens
SKILL.md length
438 words
Files
6
Skills in repo
51
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when exposing Spring Boot 4 application capabilities through Model Context Protocol tools, resources, or prompts.

  • Exposing Spring Boot 4 application capabilities through Model Context Protocol tools
  • SKILL.md covers Dependencies, Native Spring AI MCP tools, Transport configuration and Security and operations, plus 3 more sections
  • Runs Java scripts from its folder
  • Tasks that involve MCP servers

What it does

MCP Server is an agent skill from rrezartprebreza/spring-boot-skills. Use when exposing Spring Boot 4 application capabilities through Model Context Protocol tools, resources, or prompts. Covers Spring AI 2.0 MCP annotations, transport selection, schemas, errors, security, and the standalone MCP Java SDK 2.x.

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 8 other files (for example `agents/openai.yaml` and `templates/mcp.json`).

It sits in Backend & APIs, covering MCP servers and Backend development. It works with Model Context Protocol, Spring Boot and Java. The repository describes itself as: Production-grade Claude Code and Codex skills for Spring Boot developers. The licence is MIT.

When your agent uses it

  • Exposing Spring Boot 4 application capabilities through Model Context Protocol tools
  • Tasks that involve MCP servers
  • Tasks that involve Backend development

Example prompts

  • “/mcp-server”

What it can do on your machine

Read from SKILL.md and the folder at commit f0c06a0. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships script files (Java), which the agent can run.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • docs.spring.io
    • github.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

MCP Server loads about 1.3k tokens when it runs. Until then it costs about 63 tokens; SKILL.md has 438 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~63
When it runs · the whole SKILL.md, loaded when a task matches
~1.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from rrezartprebreza/spring-boot-skills at commit f0c06a0, republished under its MIT licence (© rrezartprebreza). 438 words, ~1,291 tokens.

Download SKILL.mdSave it as .claude/skills/mcp-server/SKILL.md (or your agent's skills folder). This skill also uses 5 other files; get the full folder from GitHub.
name
mcp-server
description
Use when exposing Spring Boot 4 application capabilities through Model Context Protocol tools, resources, or prompts. Covers Spring AI 2.0 MCP annotations, transport selection, schemas, errors, security, and the standalone MCP Java SDK 2.x.

MCP Server - Spring AI 2.0 and Java SDK 2.x

Prefer Spring AI's MCP server starters and native annotations in Spring Boot applications. Use the standalone SDK only when Spring integration is intentionally not required.

Dependencies

Let the Spring AI BOM manage every Spring AI and MCP transitive dependency. Do not override its MCP SDK version independently.

xml
<!-- Pick exactly one transport starter. -->
<dependency>
    <groupId>org.springframework.ai</groupId>
    <artifactId>spring-ai-starter-mcp-server</artifactId>
</dependency>
<!-- Remote MVC: spring-ai-starter-mcp-server-webmvc -->
<!-- Remote reactive: spring-ai-starter-mcp-server-webflux -->

For an application that uses the raw SDK without Spring AI, use the current 2.x release and follow its 2.0 migration guide. MCP Java SDK 2.0 tracks the 2025-11-25 protocol and prefers Streamable HTTP; SSE transports are deprecated.

xml
<dependency>
    <groupId>io.modelcontextprotocol.sdk</groupId>
    <artifactId>mcp</artifactId>
    <version>2.0.0</version>
</dependency>

Native Spring AI MCP tools

Use @McpTool and @McpToolParam for server capabilities. @Tool is Spring AI's model tool-calling API; it is not the native MCP server annotation.

java
@Component
final class OrderMcpTools {
    private final OrderService orderService;

    OrderMcpTools(OrderService orderService) {
        this.orderService = orderService;
    }

    @McpTool(
        name = "get_order",
        description = "Get an order by UUID with line items and status history",
        generateOutputSchema = true,
        annotations = @McpTool.McpAnnotations(
            readOnlyHint = true,
            destructiveHint = false,
            idempotentHint = true))
    OrderResponse getOrder(
            @McpToolParam(description = "Order UUID", required = true) String orderId) {
        return OrderResponse.from(orderService.findById(UUID.fromString(orderId)));
    }
}
  • Return DTOs or records, not persistence entities.
  • Set tool hints accurately; clients must still treat them as untrusted metadata.
  • Use stable, specific descriptions because the model uses them to select tools.
  • Align return types with server mode: synchronous methods for SYNC, reactive types for ASYNC.
  • For expected failures, return a stable structured result. Do not expose stack traces or secrets.
  • Use MCP SDK builders such as CallToolResult.builder(); legacy result constructors were removed.

Transport configuration

yaml
spring:
  main:
    banner-mode: "off"
  ai:
    mcp:
      server:
        name: order-service-mcp
        version: 1.0.0
        type: SYNC
        stdio: true
        annotation-scanner:
          enabled: true

For a remote server, select the MVC or WebFlux starter and set spring.ai.mcp.server.protocol=STREAMABLE or STATELESS. Use SSE only for compatibility with an older client. A stdio server must keep stdout free of banners, logs, and System.out output because stdout carries JSON-RPC frames.

Show full SKILL.md (201 more words)Show less

Security and operations

  • Authenticate and authorize remote MCP endpoints like any other privileged application API.
  • Validate tool arguments and apply domain authorization inside every capability.
  • Keep destructive tools narrow and require explicit business preconditions.
  • Bound execution time, result size, pagination, and downstream fan-out.
  • Log tool name, outcome, duration, and authenticated actor without recording secrets or full data.
  • Test initialization, discovery, invalid arguments, authorization, cancellation, and shutdown with a real MCP client.

Examples

  • See examples/OrderMcpTools.java, examples/good-order-tools.java, and examples/bad-order-tools.java.

Official sources

Gotchas

  • Agent uses @Tool for native server registration - use @McpTool and @McpToolParam.
  • Agent overrides the MCP SDK under a Spring AI starter - let the Spring AI BOM manage it.
  • Agent uses removed new CallToolResult(...) constructors - use CallToolResult.builder().
  • Agent configures SSE for a new remote server - prefer Streamable HTTP.
  • Agent logs to stdout in stdio mode - route logs to stderr or a file and disable the banner.
  • Agent mixes synchronous methods with an asynchronous server - the annotation scanner filters mismatched methods.
  • Agent exposes entities or unbounded collections - return bounded DTO contracts.
  • Agent trusts tool hints as authorization - enforce authorization in application code.

© rrezartprebreza, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 5 other files in skills/spring-boot-4/mcp-server of rrezartprebreza/spring-boot-skills.

  • SKILL.md
  • agents/openai.yaml
  • examples/OrderMcpTools.java
  • examples/bad-order-tools.java
  • examples/good-order-tools.java
  • templates/mcp.json

Open the folder on GitHubat commit f0c06a0

Compare with similar skills

MCP Server next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

MCP Server compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
MCP Server this skillrrezartprebreza/spring-boot-skills301—~1.3kAutomated safety check: PassMIT
Intelliconnect Service Styleruanrongman/IntelliConnect147—~2.4kAutomated safety check: PassApache-2.0
Java MCP Server Generatorgithub/awesome-copilot40k1 repos~5.5kAutomated safety check: PassMIT
Java Coding StandardsSnailclimb/AIGuide675—~1kAutomated safety check: PassNone
Solon Development Skillopensolon/soloncode197—~1.8kAutomated safety check: PassMIT
Spring ExploreAmplicode/spring-skills128—~4.1kAutomated safety check: PassNone

Similar skills

  • Intelliconnect Service Style

    ruanrongman/IntelliConnect

    Create or update IntelliConnect Spring Boot service/serviceimpl code in this repository style.

    147 GitHub stars~2.4k tokensUpdated 3 days ago
    Backend & APIsAuto-check passed
  • Java MCP Server Generator

    github/awesome-copilot

    Official

    Generate a complete Model Context Protocol server project in Java using the official MCP Java SDK with reactive streams and optional Spring Boot integration.

    40k GitHub starsUsed in 1 repo~5.5k tokens
    Agent WorkflowsAuto-check passed
  • Java Coding Standards

    Snailclimb/AIGuide

    Java/Spring Boot 编码规范:用于编写、审查、重构和讲解 Java 代码。适用于 Java 风格、Spring Boot 架构、Controller/Service/Manager/DAO 分层、API 边界、Entity/VO/Form/DTO/BO 设计、MyBatis/MyBatis-Plus 持久化、事务、异常、日志、安全、性能、测试和 Java 代码评审等场景。默认结合…

    675 GitHub stars~1k tokensUpdated 3 mo ago
    Backend & APIsAuto-check passed
  • Solon Development Skill

    opensolon/soloncode

    Solon Java framework expert (NOT Spring). An agent skill from opensolon/soloncode.

    197 GitHub stars~1.8k tokensUpdated 3 days ago
    Backend & APIsAuto-check passed
  • Spring Explore

    Amplicode/spring-skills

    Explores a Spring Boot application and builds primary context: tech stack, module structure, domain entities, REST endpoints.

    128 GitHub stars~4.1k tokensUpdated 1 mo ago
    Backend & APIsAuto-check passed
  • Kafka Configuration

    Amplicode/spring-skills

    Configures Spring Boot's Kafka starter through application.properties / application.yml.

    128 GitHub stars~4k tokensUpdated 1 mo ago
    Backend & APIsAuto-check passed

More from rrezartprebreza/spring-boot-skills

All 51 skills in this repo
  • AI Observability

    rrezartprebreza/spring-boot-skills

    A skill your agent uses when adding Spring AI-specific model observations, token usage, latency, externally configured cost attribution, advisor telemetry, or protected prompt and completion logging.

    301 GitHub stars~1.6k tokensUpdated 19 days ago
    Auto-check passed
  • API Versioning

    rrezartprebreza/spring-boot-skills

    A skill your agent uses when versioning Spring MVC or WebFlux APIs in Spring Boot 3 / Spring Framework 6.

    301 GitHub stars~516 tokensUpdated 19 days ago
    Auto-check passed
  • API Versioning

    rrezartprebreza/spring-boot-skills

    A skill your agent uses when versioning Spring MVC or WebFlux APIs in Spring Boot 4 / Spring Framework 7.

    301 GitHub stars~643 tokensUpdated 19 days ago
    Auto-check passed
  • Container Native Deployment

    rrezartprebreza/spring-boot-skills

    A skill your agent uses when packaging a Spring Boot 3 application as an OCI image or GraalVM native executable.

    301 GitHub stars~781 tokensUpdated 19 days ago
    Auto-check passed
  • Container Native Deployment

    rrezartprebreza/spring-boot-skills

    A skill your agent uses when packaging Spring Boot 4 as an OCI image, JVM container, AOT application, or GraalVM native executable.

    301 GitHub stars~706 tokensUpdated 19 days ago
    Auto-check passed
  • Domain Driven Design

    rrezartprebreza/spring-boot-skills

    A skill your agent uses when evolving aggregate invariants, value objects or domain events in an existing DDD-style Spring Boot 3 application, or when DDD is explicitly requested.

    301 GitHub stars~2.1k tokensUpdated 19 days ago
    Auto-check passed

Questions about MCP Server

What does MCP Server do?

A skill your agent uses when exposing Spring Boot 4 application capabilities through Model Context Protocol tools, resources, or prompts. MCP Server is an agent skill from rrezartprebreza/spring-boot-skills. Use when exposing Spring Boot 4 application capabilities through Model Context Protocol tools, resources, or prompts.

When should I use MCP Server?

MCP Server fits situations like: exposing Spring Boot 4 application capabilities through Model Context Protocol tools; tasks that involve MCP servers; tasks that involve Backend development.

How do I install MCP Server in Claude Code?

Run `npx skills add rrezartprebreza/spring-boot-skills --skill mcp-server -a claude-code`. Or copy the skill folder (skills/spring-boot-4/mcp-server in rrezartprebreza/spring-boot-skills) into .claude/skills/mcp-server in your project. Claude Code loads it when a task matches its description.

How do I install MCP Server in Codex?

Run `npx skills add rrezartprebreza/spring-boot-skills --skill mcp-server -a codex`. Or copy the skill folder (skills/spring-boot-4/mcp-server in rrezartprebreza/spring-boot-skills) into .agents/skills/mcp-server in your project. Codex loads it when a task matches its description.

Can I use MCP Server in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add rrezartprebreza/spring-boot-skills --skill mcp-server -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/mcp-server, .gemini/skills/mcp-server, .github/skills/mcp-server and .opencode/skills/mcp-server in your project.

What does MCP Server need to run?

Going by SKILL.md and its folder, MCP Server needs Java for the scripts in its folder.

Does MCP Server access the network?

SKILL.md names 2 domains. As links in the text: docs.spring.io and github.com. This is read from the text; nothing was executed.

Is MCP Server safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does MCP Server use?

MCP Server is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does MCP Server use?

About 1.3k tokens (SKILL.md is roughly 5.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to MCP Server?

Skills that share tags, products or a category with MCP Server: Intelliconnect Service Style (ruanrongman/IntelliConnect, 147 stars), Java MCP Server Generator (github/awesome-copilot, 40k stars), Java Coding Standards (Snailclimb/AIGuide, 675 stars) and Solon Development Skill (opensolon/soloncode, 197 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains MCP Server?

rrezartprebreza (a GitHub user) maintains it in rrezartprebreza/spring-boot-skills, which has 301 GitHub stars. The repository holds 51 skills in this directory. The repository was last updated on September 21, 2026.

Source: rrezartprebreza/spring-boot-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.