MCP Steroid

Give AI the whole IntelliJ, not just the files
AI agents can finally SEE IntelliJ - not just read code

Website • Demo Videos • Blog Post • Get Trial Access

---

About MCP Steroid

MCP Steroid is an independent research project that brings the full power of the IntelliJ Platform to AI agents through the Model Context Protocol (MCP).

The Mission

IntelliJ platform works for AI agents as great as for human developers.

Unlike LSP-only solutions, MCP Steroid gives AI agents the same powerful IDE capabilities that developers use: semantic understanding, advanced refactorings, debugging, test running, and visual awareness.

What Makes It Unique

MCP Steroid is the only MCP server offering ALL of:

• ✨ Visual IDE understanding - Screenshots + OCR + component tree
• 🎯 UI automation capabilities - Control the IDE like a human
• 🔧 Native IntelliJ APIs - PSI, inspections, refactorings, and more
• ⚡ Kotlin scripting - Full platform access at runtime
• 🛡️ Human-in-the-loop safety - 3 review modes (ALWAYS/TRUSTED/NEVER)
• 🌐 Standard MCP protocol - Works with ANY AI agent

Verified Capabilities

• 9 MCP Tools - Control IntelliJ programmatically
• 58 MCP Resources - Comprehensive guides and examples
• All IntelliJ Platform IDEs - IDEA, PyCharm, WebStorm, GoLand, CLion, Rider, and more
• Requirements - IntelliJ 2025.3 or newer (build 253.*)

---

Get Started

🎯 Get Trial Access

The plugin is currently in early access. Message Eugene Petrenko on LinkedIn to get access to the latest build.

📖 Learn More

• Website: mcp-steroid.jonnyzzz.com
• Blog Post: MCP Steroids for IntelliJ
• Demo Videos: YouTube Playlist

---

Featured Demo Videos

Video	Description	Duration
CodeDozer Demo 5	Most popular demo	1:00
CodeDozer & IntelliJ Debugger	Debugger integration showcase	8:25
Now we call tasks in IntelliJ	Task execution demo	2:21
Real Work in Monorepo Part 2	Deep dive into real workflow	18:37
Cursor Talks with IntelliJ	Cursor integration	0:44
Antigravity Mandelbrot Window	Visual capabilities demo	0:39

Watch all demos: MCP Steroid Playlist

---

Compatible AI Agents

Works with ANY MCP-compatible client:

• 🤖 Claude (Claude Code, Claude Desktop)
• 💬 ChatGPT with MCP support
• 🌟 Gemini CLI
• 🦙 Llama models via MCP clients
• 📝 Codex CLI
• ✏️ Cursor IDE
• 🎨 Junie
• 🔓 OpenCode
• 🔌 Any other MCP-compatible client

---

Key Features

9 MCP Tools

1. List Projects - Discover all open IntelliJ projects
2. List Windows - Enumerate IDE windows and components
3. Execute Code - Run Kotlin code in IDE runtime
4. Execute Feedback - Provide execution results to agents
5. Capabilities Discovery - Explore available IDE features
6. Action Discovery - Find and invoke IDE actions
7. Vision Screenshot - Capture IDE screenshots with metadata
8. Vision Input - OCR and component tree analysis
9. Open Project - Open projects programmatically

58 MCP Resources

Comprehensive documentation and examples covering:

• LSP Operations (11 resources) - Go to definition, find references, hover, completion, and more
• IDE Power Operations (22 resources) - Refactorings, code generation, project analysis
• Debugger Integration (7 resources) - Breakpoints, thread control, debugging workflows
• Test Runner (10 resources) - Run tests, inspect results, navigate test trees
• VCS Operations (3 resources) - Git annotations, file history
• Project Workflows (4 resources) - Open projects with different trust levels
• Skill Guides (3 resources) - IntelliJ API, debugger, and test runner guides

---

Configuration

MCP Steroid can be configured via IntelliJ's Registry (Help → Find Action → Registry) or JVM system properties.

Registry Key	Default	Description
mcp.steroid.server.port	6315	MCP server port (0 for auto-assign)
mcp.steroid.server.host	127.0.0.1	Bind address (use 0.0.0.0 for Docker)
mcp.steroid.review.mode	ALWAYS	Review mode: ALWAYS, TRUSTED, or NEVER
mcp.steroid.storage.path	(empty)	Custom storage path (default: .idea/mcp-steroid/)

Finding the MCP Server URL: When the plugin starts, it writes the server URL to .idea/mcp-steroid.md in each open project. The first line contains the URL (e.g., http://127.0.0.1:6315/mcp).

See the full Configuration Documentation on the website.

---

Architecture

• Technology: Kotlin 2.2.21 on Java 21
• HTTP Server: Ktor 3.1.0
• Transport: HTTP + SSE (Server-Sent Events)
• Protocol: Model Context Protocol (MCP)
• Port: 6315 (default)
• OCR: Tesseract 5.5.1
• Platform: IntelliJ Platform Plugin SDK

---

About the Project

MCP Steroid is an independent research project by Eugene Petrenko (@jonnyzzz).

Not affiliated with, endorsed by, or supported by JetBrains s.r.o.

IntelliJ IDEA, IntelliJ Platform, PyCharm, WebStorm, and JetBrains are trademarks of JetBrains s.r.o.

---

Links

• 🌐 Website: mcp-steroid.jonnyzzz.com
• 📝 Blog: jonnyzzz.com
• 🎥 YouTube: @jonnyzzz
• 💼 LinkedIn: jonnyzzz
• 🐦 X/Twitter: @jonnyzzz
• 💻 Source Code: Available upon request for trial participants

---

Feedback & Issues

Found a bug or have a feature request? Please report it in the Issues section.

---

_{Built with ❤️ for the AI agent developer community}