MCP Directory

How to add Aibolit MCP Server to Claude Desktop

Points your AI agent to the most critical design issue in Java code so refactoring fixes what matters. Paste the config into ~/Library/Application Support/Claude/claude_desktop_config.json and restart Claude Desktop.

Last updated June 14, 2026 · 26★ · stdio · no auth

Claude Desktop config for Aibolit MCP Server

claude mcp add aibolit npx aibolit-mcp-server@0.0.6
{
  "mcpServers": {
    "aibolit-mcp-server": {
      "command": "npx",
      "args": [
        "aibolit-mcp-server@0.0.6"
      ]
    }
  }
}

Setup steps

  1. 1Open Claude Desktop → Settings → Developer → Edit Config (this opens ~/Library/Application Support/Claude/claude_desktop_config.json).
  2. 2Paste the Aibolit MCP Server config below under the top-level "mcpServers" key.
  3. 3Fill in any placeholder secrets (API keys, paths) in the snippet.
  4. 4Save the file, then fully quit and reopen Claude Desktop.
  5. 5Open a chat and confirm Aibolit MCP Server's tools appear under the 🔌 tools menu.

Before you start

  • Node 18+ and Npm
  • Python and Pip
  • The aibolit CLI installed and on PATH (verify with `aibolit --version`)
  • An MCP-capable agent such as Claude Code, Cursor, or Windsurf

What Aibolit MCP Server can do in Claude Desktop

find_the_most_critical_design_issue

Analyzes one Java file (given a `path`) using Aibolit and returns the single most serious design flaw that needs immediate refactoring, pointing out the problem and where it is. Ignores cosmetic and minor issues and focuses on maintainability, readability, loose coupling, and high cohesion.

Security

Runs locally over stdio with no authentication. The server reads the Java file paths it is asked to analyze and shells out to the locally installed aibolit Python tool, so it requires aibolit (and its Python/Pip runtime) to be installed on the host.

Aibolit MCP Server + Claude Desktop FAQ

Where is the Claude Desktop config file?

Claude Desktop reads MCP servers from ~/Library/Application Support/Claude/claude_desktop_config.json. Paste the Aibolit MCP Server config there under the "mcpServers" key and restart the client.

Is Aibolit MCP Server safe to use with Claude Desktop?

Runs locally over stdio with no authentication. The server reads the Java file paths it is asked to analyze and shells out to the locally installed aibolit Python tool, so it requires aibolit (and its Python/Pip runtime) to be installed on the host.

What languages does it analyze?

Java only — it wraps the Aibolit Java static analyzer and analyzes one Java file at a time.

Do I need to install anything besides the npm package?

Yes. You need Node, Npm, Python, Pip, and the aibolit CLI installed locally. The server runs aibolit under the hood, so `aibolit --version` should work before you start.

How do I add it to Claude Code?

Run `claude mcp add aibolit npx aibolit-mcp-server@0.0.6`, restart Claude Code, then ask it to find the most critical design issue in your code base and fix it.

View repo Full Aibolit MCP Server page