SkillAgentSearch skills...

mcp-server

Use when exposing Spring Boot 3 application capabilities through Model Context Protocol tools, resources, or prompts. Covers Spring AI 1.x tool callback registration, transports, schemas, errors, security, and standalone MCP Java SDK compatibility.

Install / Use

npx skills add rrezartprebreza/spring-boot-skills --skill mcp-server

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

86/100

Category

Security

Supported Platforms

Universal

Our assessment of mcp-server

mcp-server scores 86/100 on our quality scale, 788th of 1,108 Security skills we index.

Its SKILL.md is 4.9 KB long, well organised into 8 sections with 4 code examples: a solid amount of guidance for an agent.

It has 334 GitHub stars, a meaningful sign that others use it.

Substance
26/30
Structure
20/20
Description
15/15
Adoption
11/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated 18 days ago, so mcp-server is actively maintained.
  • It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-11-12. Automated pattern scan on 2026-11-12. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

mcp-server compared with similar skills

All 4 of these similar skills score higher than mcp-server; compare them before choosing.

SkillScoreStarsUpdatedFormat
mcp-server (this skill)by rrezartprebreza8633418d agoSKILL.md
Agent-Reachby Panniantong100112.3k8d agoCLAUDE.md
rufloby ruvnet10081.9ktodayCLAUDE.md
headroomby headroomlabs-ai10079.8ktodayCLAUDE.md
CowAgentby zhayujie10048.0ktodayCLAUDE.md

Frequently asked questions

How do I install mcp-server?
Run npx skills add rrezartprebreza/spring-boot-skills --skill mcp-server. The install tabs above show the steps for each supported agent.
Which AI agents does mcp-server work with?
It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
Is mcp-server safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is mcp-server still maintained?
The repository was last updated 18 days ago, so mcp-server is actively maintained.

name: mcp-server description: > Use when exposing Spring Boot 3 application capabilities through Model Context Protocol tools, resources, or prompts. Covers Spring AI 1.x tool callback registration, transports, schemas, errors, security, and standalone MCP Java SDK compatibility.

MCP Server - Spring Boot 3

Prefer the Spring AI MCP server starters in a Spring Boot application. Let the Spring AI BOM manage its MCP SDK dependency; do not force the standalone SDK version into a starter-based application.

Dependencies

<!-- 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 a raw SDK application without Spring AI, use the current MCP Java SDK 2.x release and follow its migration guide. Do not assume raw SDK examples match the version managed by Spring AI 1.x.

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

Spring AI 1.x tool callback integration

Spring AI 1.0.x exposes @Tool methods only through an explicit MethodToolCallbackProvider — a bare @Component with @Tool methods registers nothing. Spring AI 1.1.x additionally supports native @McpTool/@McpToolParam with spring.ai.mcp.server.annotation-scanner.enabled=true, imported from org.springaicommunity.mcp.annotation (Spring AI 2.0 moved them to org.springframework.ai.mcp.annotation). Pick one registration path per tool.

@Configuration
class McpToolsConfiguration {
    @Bean
    ToolCallbackProvider orderTools(OrderMcpTools tools) {
        return MethodToolCallbackProvider.builder()
            .toolObjects(tools)
            .build();
    }
}

@Component
final class OrderMcpTools {
    private final OrderService orderService;

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

    @Tool(description = "Get an order by UUID with line items and status history")
    OrderResponse getOrder(
            @ToolParam(description = "Order UUID") String orderId) {
        return OrderResponse.from(orderService.findById(UUID.fromString(orderId)));
    }
}
  • Return DTOs rather than serialized JPA entities.
  • Register each tool object once; duplicate providers create duplicate capabilities.
  • Keep tool names and descriptions stable because clients and models depend on them.
  • Bound result size, execution time, and downstream calls.
  • For raw SDK code, use builders such as CallToolResult.builder(); old constructors were removed.

Transport configuration

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

Use stdio when a local client launches the jar. Use the matching MVC or WebFlux starter and Streamable HTTP for a remote server when supported by the selected Spring AI 1.x release. Keep stdout clean in stdio mode because it carries JSON-RPC frames.

Security and verification

  • Authenticate and authorize remote MCP endpoints and every underlying domain operation.
  • Validate identifiers, enum values, pagination, and result limits.
  • Do not expose secrets, stack traces, persistence entities, or unrestricted administrative tools.
  • Test discovery, invalid arguments, authorization, timeouts, and shutdown with a real MCP client.
  • Review the selected Spring AI 1.x release notes before copying 2.0 annotation examples.

Examples

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

Official sources

  • Spring AI MCP overview: https://docs.spring.io/spring-ai/reference/api/mcp/mcp-overview.html
  • MCP Java SDK releases: https://github.com/modelcontextprotocol/java-sdk/releases
  • MCP Java SDK 2.0 migration: https://github.com/modelcontextprotocol/java-sdk/blob/main/MIGRATION-2.0.md

Gotchas

  • Agent overrides the MCP SDK under Spring AI 1.x - let the Spring AI BOM manage it.
  • Agent copies Spring AI 2.0 org.springframework.ai.mcp.annotation imports into a 1.1 project - 1.1 uses org.springaicommunity.mcp.annotation, and 1.0 has no MCP annotations at all.
  • Agent expects @Tool methods on a plain @Component to appear as MCP tools in 1.x - register them through a ToolCallbackProvider bean.
  • Agent passes --spring.ai.mcp.server.transport=stdio - no such property; Boot ignores it silently. Use spring.ai.mcp.server.stdio=true.
  • Agent uses removed new CallToolResult(...) constructors in raw SDK code - use builders.
  • Agent logs to stdout in stdio mode - route logs to stderr or a file and disable the banner.
  • Agent registers the same tool object twice - keep one callback provider per capability.
  • Agent exposes entities or unbounded collections - return bounded DTO contracts.

Related Skills

View on GitHub
GitHub Stars334
CategorySecurity
Updated18d ago
Forks54

Languages

Java

Trust signals

100/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

No cautions