springdocs

The Spring Documentation MCP Server exposes a suite of tools designed to help you explore, search, and interact with Spring documentation, guides, tutorials, and ecosystem resources through the MCP protocol. It includes core tools for searching Spring docs, listing guides, retrieving detailed project or guide content, and referencing Spring framework documentation. New advanced tools expand capabilities to explore the broader Spring ecosystem, run tutorials, compare versions, and diagnose issues. You can call these tools via any MCP-compatible client (CLI, IDE integration, or graphical front-ends) using the typical MCP request format, for example tools/list to enumerate available tools and tools/call to execute a specific tool with arguments. The server is designed to be easily discoverable and configurable via environment-friendly commands like npx or integrating directly into your MCP client configuration.

To get started, connect to the MCP server using the recommended npx invocation shown in the quick start guide. From there, you can search for REST API documentation, fetch Spring project details, retrieve entire guides or tutorials, and explore concepts within the Spring ecosystem. This makes it convenient to embed Spring documentation and learning resources directly into your development workflow across editors and IDEs that support MCP. The tooling also emphasizes cached results and efficient queries to deliver faster responses during ongoing research or learning sessions.

Prerequisites:

• Node.js 18+ and npm installed on your machine
• Access to npm registry (public or authenticated if required)

Step-by-step installation:

1. Install the MCP server globally using NPX (no permanent installation needed):

   • npx @enokdev/springdocs-mcp@latest

2. Optional: Install as a global CLI for convenience (requires npm global install):

   • npm install -g @enokdev/springdocs-mcp
   • springdocs-mcp

3. If you prefer to integrate into a project or CI, reference via MCP config:

   • Use the following mcpServers entry in your MCP config file:

{
  "mcpServers": {
    "spring-docs": {
      "command": "npx",
      "args": ["@enokdev/springdocs-mcp@latest"]
    }
  }
}

Prerequisites recap:

• Ensure Node.js 18+ is installed
• Ensure npm can access the npm registry
• Have a compatible MCP client ready to consume the server

Tip: If you encounter permissions issues when installing globally, use a Node version manager (nvm) and ensure npm global bin is in your PATH.

Notes and tips:

• The server supports a broad set of tools, including core documentation tools and advanced ecosystem tools. You can enable more efficient queries through caching and optional environment variables (for example, NODE_OPTIONS to configure memory usage).
• Docker distribution is listed as coming soon; if you plan to use Docker in the future, keep an eye on the catalog updates and security benefits like SBOMs and signatures.
• Common config locations for Claude, VS Code, JetBrains, and Claude Code are documented in the README; these paths are useful if you want to preseed or verify MCP configurations in your environment.
• If you run into performance or connectivity issues, you can rely on the troubleshooting guidance in the README, including clearing npm cache, updating the MCP package, and testing basic tool calls with tools/list.
• When using proxies or corporate networks, you can set HTTP_PROXY and HTTPS_PROXY or any necessary proxy configuration via your MCP config env block to ensure outbound calls to npm registries and external docs continue to work.