Spring Boot + Spring AI Documentation Access
A comprehensive Model Context Protocol server providing intelligent access to Spring Boot, Spring AI, and Spring Framework documentation with advanced tutorials, intelligent caching, and Docker distribution support.
Enhanced Performance & Reliability
Core Features
Complete Spring Ecosystem Enhanced
Access all Spring projects with intelligent caching: Boot, Security, Data, Cloud, and more. Get detailed information with enhanced performance.
Spring AI Documentation New
Complete Spring AI documentation including ChatClient, RAG, embeddings, vector stores, and LLM integrations (OpenAI, Anthropic, Azure, Ollama).
Docker Distribution New
Official Docker image with multi-stage builds, non-root security (UID 1001), cryptographic signatures, and Docker MCP Catalog integration.
Step-by-Step Tutorials New
Progressive tutorials for REST APIs, JPA, Security, and Testing with beginner, intermediate, and advanced levels.
Ecosystem-Wide Search New
Search across the entire Spring ecosystem in one query with intelligent categorization and caching.
Smart Diagnostics New
Intelligent diagnosis of common Spring Boot issues with automated solutions and troubleshooting guides.
Version Migration New
Smart comparison of Spring Boot versions with detailed migration guidance and breaking change analysis.
Expert Best Practices New
Curated best practices for architecture, performance, security, testing, configuration, and deployment by experience level.
Quick Installation
Universal Configuration (Works with ANY MCP Client)
# No installation required! Always uses latest version
npx @enokdev/springdocs-mcp@latest
Claude Desktop/Code Configuration:
{
"mcpServers": {
"spring-docs": {
"command": "npx",
"args": ["@enokdev/springdocs-mcp@latest"],
"description": "Spring Documentation MCP Server with 17 powerful tools"
}
}
}
Gemini CLI Configuration:
mcp_servers:
spring-docs:
command: "npx"
args: ["@enokdev/springdocs-mcp@latest"]
description: "Spring Documentation Server"
VS Code MCP Extension:
{
"mcp.servers": {
"spring-docs": {
"command": "npx",
"args": ["@enokdev/springdocs-mcp@latest"]
}
}
}
Global Installation Option
npm install -g @enokdev/springdocs-mcp
Configuration:
{
"mcpServers": {
"spring-docs": {
"command": "springdocs-mcp"
}
}
}
Docker Distribution (Coming Soon)
Official Docker image submitted to Docker MCP Catalog - awaiting approval
# Docker MCP CLI (When available)
docker mcp add springdocs-mcp
# Docker Run
echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/list"}' | \
docker run -i mcp/springdocs-mcp
# Docker Compose
services:
springdocs-mcp:
image: mcp/springdocs-mcp:latest
stdin_open: true
environment:
- REQUEST_TIMEOUT=15000
- NODE_OPTIONS=--max-old-space-size=4096
Features: Cryptographic signatures, SBOMs, non-root security (UID 1001), ~220MB Alpine-based image
Performance Optimization
{
"mcpServers": {
"spring-docs": {
"command": "npx",
"args": ["@enokdev/springdocs-mcp@latest"],
"env": {
"NODE_OPTIONS": "--max-old-space-size=4096"
}
}
}
}
All 17 Available Tools
Enhanced Original Tools (8)
search_spring_docs Enhanced
Search through Spring Boot documentation with intelligent caching and parallel processing for faster results.
search_spring_projects Enhanced
Find Spring projects with enhanced fallbacks and keyword expansion for better matching.
get_spring_project Enhanced
Get detailed project information with long-term caching and enhanced error recovery.
get_all_spring_guides Enhanced
Browse all available Spring guides with cached listings and improved filtering.
get_spring_guide Enhanced
Retrieve guide content from multiple sources (Spring.io + GitHub) with robust fallback mechanisms.
get_spring_reference Enhanced
Access reference documentation with long-term caching and enhanced content extraction.
search_spring_concepts Enhanced
Explore Spring Boot concepts with extended database and better keyword matching.
get_migration_guide Enhanced
Get the Spring Boot migration guide or upgrade release notes for a target version, optionally filtered by section (e.g. jakarta).
Advanced New Tools (9)
search_spring_ecosystem New
Search across the entire Spring ecosystem with categorized results from projects, guides, docs, and APIs in one query.
get_spring_tutorial New
Get comprehensive step-by-step tutorials for REST APIs, JPA, Security, and Testing with multiple difficulty levels.
compare_spring_versions New
Compare Spring Boot versions with detailed migration guidance, breaking changes analysis, and upgrade recommendations.
get_spring_best_practices New
Get curated best practices for architecture, performance, security, testing, configuration, and deployment by experience level.
diagnose_spring_issues New
Intelligent diagnosis of common Spring Boot issues with automated solutions, troubleshooting steps, and prevention strategies.
get_release_notes New
Fetch GitHub release notes for a Spring project (a specific version or the latest), filtered on breaking changes, new features or deprecations.
spring_cache_stats New
Show cache statistics (entries, expired, capacity) and optionally purge expired entries or the whole cache.
get_spring_initializr New
List Spring Initializr build options and dependencies, with a text filter on id, name or description.
find_spring_dependency New
Find the Spring starters matching a need, with ready-to-paste Maven and Gradle snippets.
Usage Examples
Simple queries to get started with Spring Documentation MCP Server
Release History
Latest updates and improvements
Docker Distribution
- Official Docker image with multi-stage builds
- Docker MCP Catalog integration ready
- Enhanced security: non-root user, cryptographic signatures, SBOMs
- ~220MB optimized Alpine-based image
Spring AI Support
- Complete Spring AI documentation access (ChatClient, RAG, embeddings)
- Multi-project architecture for scalable Spring ecosystem support
- LLM integrations: OpenAI, Anthropic, Azure, Ollama
- Vector stores and advanced AI features
Advanced Features
- 5 advanced tools: ecosystem search, tutorials, version comparison
- In-memory caching (30 min TTL, 24 h for stable content)
- Universal MCP compatibility (Claude Code, Gemini CLI, VS Code, JetBrains)
- Best practices and intelligent issue diagnosis
Get Started
Install the comprehensive Spring documentation server for any MCP-compatible client