How to add Aibolit MCP Server to Cursor
Points your AI agent to the most critical design issue in Java code so refactoring fixes what matters. Paste the config into ~/.cursor/mcp.json and restart Cursor.
Last updated June 14, 2026 · 26★ · stdio · no auth
Cursor 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
- 1Open Cursor → Settings → MCP → Add new MCP server (or edit ~/.cursor/mcp.json directly).
- 2Paste the Aibolit MCP Server config below into the "mcpServers" object.
- 3Fill in placeholder secrets, then save.
- 4Cursor reloads MCP servers automatically — check Settings → MCP for a green status dot.
- 5Ask Cursor to use one of Aibolit MCP Server's tools to confirm it's connected.
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 Cursor
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.
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 + Cursor FAQ
Where is the Cursor config file?
Cursor reads MCP servers from ~/.cursor/mcp.json. Paste the Aibolit MCP Server config there under the "mcpServers" key and restart the client.
Is Aibolit MCP Server safe to use with Cursor?
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.