Spring Docs

What is Spring Docs?

Spring Docs is an MCP server that provides 12 tools for searching, exploring, and interacting with the Spring ecosystem documentation, guides, tutorials, and best practices. It is designed for developers using MCP-compatible clients like Claude Code, Gemini CLI, VS Code, and JetBrains IDEs.

How to use Spring Docs?

Install the server via npx (npx @enokdev/springdocs-mcp@latest) or globally (npm install -g @enokdev/springdocs-mcp). Configure it in your MCP client's config file using the command and args shown in the README, then invoke tools by natural language prompts such as "Search for REST API documentation in Spring Boot" or "Diagnose 'Failed to configure DataSource' error".

Key features of Spring Docs

• 12 tools including documentation search, project lookup, guide retrieval, and reference fetching.
• 5 advanced tools: ecosystem search, tutorials, version comparison, best practices, and diagnostics.
• Intelligent caching achieving 85% cache hit rate and 50–80% faster response times.
• Auto-retry logic with exponential backoff for 99.5% reliability.
• Supports parallel processing and multiple data sources.
• Universal compatibility with all MCP-compatible clients.

Use cases of Spring Docs

• Quickly search Spring Boot, Spring Security, or any Spring project documentation.
• Compare Spring Boot versions for migration planning.
• Get step-by-step tutorials for building REST APIs or microservices.
• Diagnose common Spring Boot errors like port conflicts or DataSource configuration.
• Retrieve expert best practices for security, architecture, or testing.

FAQ from Spring Docs

What runtime does Spring Docs require?

Node.js 18 or higher is required.

How does Spring Docs caching work?

The server uses intelligent caching that automatically caches documentation results. In v1.2.3+, caching is enabled by default, achieving an 85% cache hit rate and reducing response times by 50–80%.

Where is the server configuration stored?

Config file locations depend on the client: for Claude Desktop it is ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows); for Claude Code it is ~/.claude-code/mcp-config.json; for VS Code it is ~/.vscode/mcp-settings.json; and for JetBrains IDEs it is .jetbrains/mcp-config.json.

Can Spring Docs be used in a corporate/proxy environment?

Yes, you can configure HTTP_PROXY and HTTPS_PROXY environment variables in the MCP server configuration to route traffic through a corporate proxy.

What transport protocol does Spring Docs use?

Spring Docs uses the Model Context Protocol (MCP) via standard input/output (stdio) transport, as shown by the JSON-RPC invocation examples in the README. No authentication is mentioned.