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-serverInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
SecuritySupported Platforms
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.
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 foundOur 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.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| mcp-server (this skill)by rrezartprebreza | 86 | 334 | 18d ago | SKILL.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 8d ago | CLAUDE.md |
| rufloby ruvnet | 100 | 81.9k | today | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.8k | today | CLAUDE.md |
| CowAgentby zhayujie | 100 | 48.0k | today | CLAUDE.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.
Skill content
View source on GitHubname: 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, andexamples/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.annotationimports into a 1.1 project - 1.1 usesorg.springaicommunity.mcp.annotation, and 1.0 has no MCP annotations at all. - Agent expects
@Toolmethods on a plain@Componentto appear as MCP tools in 1.x - register them through aToolCallbackProviderbean. - Agent passes
--spring.ai.mcp.server.transport=stdio- no such property; Boot ignores it silently. Usespring.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
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
ruflo
81.9k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
headroom
79.8kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
CowAgent
48.0kOpen-source personal AI assistant & Agent Harness. Plans tasks, runs tools and skills, self-evolves with memory and knowledge. Multi-agent, multi-model, multi-channel. Lightweight, extensible, one-line install.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
