MCP Directory

How to add Aibolit MCP Server to Windsurf

Points your AI agent to the most critical design issue in Java code so refactoring fixes what matters. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

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

Windsurf 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 Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
  2. 2Paste the Aibolit MCP Server config below.
  3. 3Fill in placeholder secrets, then save.
  4. 4Click Refresh in the MCP panel.
  5. 5Aibolit MCP Server's tools become available to Cascade.

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 Windsurf

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 + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_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 Windsurf?

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