Spring Ai Mcp Server Patterns

This gives you the patterns to build MCP servers with Spring AI, letting you expose tools and prompt templates that AI models can actually call. You get `@Tool` and `@PromptTemplate` annotations that work like standard Spring components, plus stdio/HTTP/SSE transport configuration for different client types. The skill covers the full stack: defining tool handlers with `@ToolParam` documentation, securing them with Spring Security, testing with MockBean, and handling the usual production concerns like caching and error handling. If you're already in the Spring ecosystem and want to extend Claude or other AI models with custom function calling, this is more natural than building raw MCP from scratch.

skills.sh installs: 3.9K
GitHub stars: 369
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add giuseppe-trisciuoglio/developer-kit --skill spring-ai-mcp-server-patterns --agent claude-code

Installs into .claude/skills of the current project.

Files

Spring AI MCP Server Implementation Patterns

Implements MCP servers with Spring AI for AI function calling, tool handlers, and MCP transport configuration.

Overview

Production-ready MCP server patterns: @Tool functions, @PromptTemplate resources, and stdio/HTTP/SSE transports with Spring AI security.

When to Use

MCP servers, Spring AI function calling, AI tools, tool calling, custom tool handlers, Spring Boot MCP, resource endpoints, or MCP transport configuration.

Quick Reference

Core Annotations

Annotation	Target	Purpose
`@EnableMcpServer`	Class	Enable MCP server auto-configuration
`@Tool(description)`	Method	Declare AI-callable tool
`@ToolParam(value)`	Parameter	Document tool parameter for AI
`@PromptTemplate(name)`	Method	Declare reusable prompt template
`@PromptParam(value)`	Parameter	Document prompt parameter