
Aibolit MCP Server
Points your AI agent to the most critical design issue in Java code so refactoring fixes what matters.
Add to your client
Copy the config for your MCP client and paste it into its config file.
claude mcp add aibolit npx aibolit-mcp-server@0.0.6Paste into ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"aibolit-mcp-server": {
"command": "npx",
"args": [
"aibolit-mcp-server@0.0.6"
]
}
}
}Step-by-step guides: Add to Claude Desktop · Add to Cursor · Add to Windsurf
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
About Aibolit MCP Server
An MCP server from the cqfn organization (authors of Aibolit) that lets AI agents call the Aibolit Java static analyzer. It surfaces the most critical design issue in a given Java file so agents refactor what matters instead of chasing cosmetic changes. Distributed on npm and run via npx over stdio.
Tools & capabilities (1)
find_the_most_critical_design_issueAnalyzes 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.
What this server can do
Aibolit MCP Server provides tools for these capabilities — tap one to see every MCP server that does the same:
When to use it
- Asking an AI agent to find and fix the most important design problem in a Java code base rather than cosmetic nits
- Guiding automated refactoring sessions toward high-impact structural improvements
- Augmenting Claude Code, Cursor, or Windsurf with Java-specific code-quality analysis
Security notes
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 FAQ
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.
Alternatives to Aibolit MCP Server
Compare all alternatives →Microsoft's official browser-automation MCP using Playwright's accessibility tree (no vision model).
Up-to-date, version-specific library documentation injected into your coding agent.
Code intelligence engine that indexes repos into a persistent knowledge graph for AI coding agents.
Compare Aibolit MCP Server with: