This MCP server integrates the Aibolit Java code analyzer into the Model Context Protocol workflow. When queried via MCP-enabled agents (for example Claude Code), it processes a codebase to identify the most critical design issue according to Aibolit's analysis and returns a prioritized hint. This helps AI agents focus on the highest-impact refactoring opportunities rather than surface-level improvements. The server is exposed as an MCP endpoint via the npm-distributed package and can be invoked by clients that support MCP commands, allowing you to request a hotspot/critical issue for a given project snapshot.

Prerequisites:

• Node.js (18+)
• npm
• Internet access to fetch the MCP server package from npm

Installation and setup:

1. Install the MCP server via npx (as shown in the config):

   npx -y aibolit-mcp-server@0.0.6

   This will fetch and run the MCP server package compatible with the MCP protocol.

2. If you prefer to install locally for reuse, you can install the package globally or add it to a project:

   npm install -g aibolit-mcp-server@0.0.6

   or as a project dependency

   npm install aibolit-mcp-server@0.0.6

3. Start the server (if the package provides a start script, refer to its package.json; otherwise the npx invocation may launch it directly). Typical usage via MCP clients is to register the server name (e.g., "aibolit") and connect using the MCP protocol.

4. Verify connectivity with an MCP client or by following the documentation linked in the MCP ecosystem (MCP homepage).

Note: The README example demonstrates adding the server to Claude Code via:

claude mcp add aibolit npx aibolit-mcp-server@0.0.6

Adjust the commands if your environment requires a local install or a different startup workflow.

Tips and known considerations:

• The server package name used in MCP workflows is aibolit-mcp-server with version 0.0.6; ensure network access to npm registry for retrieval.
• No specific environment variables are documented in the README snippet; if you encounter issues, check the package's runtime requirements and any optional config the MCP server may accept.
• This server relies on Aibolit for analysis; ensure Java-related tooling is compatible with the Aibolit version used by the package if you extend or customize analyses.
• When integrating with Claude Code or other MCP clients, confirm the correct MCP command format (here, npx with -y) and that the client supports the server name you register ("aibolit").