You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
> **This project is deprecated but still functional.** Starting from version 2025.2, JetBrains IDEs (WebStorm, IntelliJ IDEA, PyCharm, etc.) now include a built-in MCP server that provides native integration with external clients like Claude Desktop, Cursor, VS Code, and others.
21
-
>
22
+
>
22
23
> ### 🔄 Migration Options
23
-
>
24
-
> | IDE Version | Recommended Solution | Link |
25
-
> |------------|---------------------|------|
26
-
> |**2025.2+**| Built-in MCP server |[Official Documentation](https://www.jetbrains.com/help/webstorm/mcp-server.html)|
> > The native `get_file_problems` tool requires setting `errorsOnly: false` for similar functionality to this project. The `get_project_problems` tool only returns critical errors.
A **Model Context Protocol (MCP)** server that provides JetBrains IDE code inspections with automatic IDE selection and a unified inspection profile that works across all file types.
> 📚 For detailed configuration options, see [Configuration Documentation](docs/configuration/).
219
215
220
-
221
216
## 🧪 Testing
222
217
223
218
### 1️⃣ Interactive MCP Test
@@ -246,7 +241,6 @@ The inspector opens a web interface where you can:
246
241
- Access server resources (profiles, config, detected IDEs)
247
242
- See requests/responses in real-time
248
243
249
-
250
244
## ⚙️ How It Works
251
245
252
246
### 🎯 Automatic IDE Selection
@@ -277,6 +271,7 @@ The inspector opens a web interface where you can:
277
271
>**Key Innovation**: The server uses temporary isolated configuration directories with `-Didea.config.path` and `-Didea.system.path` JVM properties. This allows inspections to run even when the IDE is already open!
278
272
279
273
**Benefits:**
274
+
280
275
- ✅ No IDE conflicts
281
276
- ✅ Parallel execution support
282
277
- ✅ Clean, isolated analysis
@@ -294,7 +289,7 @@ The inspector opens a web interface where you can:
Note: Using isolated configuration - works even if IDE is already running
297
-
292
+
298
293
📊 Analysis Results:
299
294
⚠️ Warning: Unused variable 'config' at line 42
300
295
❌ Error: Missing semicolon at line 156
@@ -303,7 +298,6 @@ The inspector opens a web interface where you can:
303
298
304
299
</details>
305
300
306
-
307
301
## 🛠️ Troubleshooting
308
302
309
303
### ❌ "JetBrains IDE inspect tool not found"
@@ -312,6 +306,7 @@ The inspector opens a web interface where you can:
312
306
> This error occurs when no JetBrains IDE can be found in standard installation locations.
313
307
314
308
**Solutions:**
309
+
315
310
- ✅ Verify that a JetBrains IDE is installed in`/Applications/` or `~/Applications/`
316
311
- ✅ Ensure the `inspect.sh` file is executable
317
312
- ✅ Use `FORCE_INSPECT_PATH` environment variable to specify the exact path
@@ -322,6 +317,7 @@ The inspector opens a web interface where you can:
322
317
> Without an inspection profile, the tool cannot analyze your code properly.
323
318
324
319
**Steps to fix:**
320
+
325
321
1. Open the project in a JetBrains IDE
326
322
2. Go to **Settings** → **Inspections**
327
323
3. Configure and save an inspection profile
@@ -333,6 +329,7 @@ The inspector opens a web interface where you can:
333
329
> Default timeout is 120 seconds. Large projects may need more time.
334
330
335
331
**Solutions:**
332
+
336
333
- 🔄 Increase timeout: Set `INSPECTION_TIMEOUT=300000` (5 minutes)
337
334
- 📊 Check that the IDE is not currently indexing
338
335
- 📦 For very large projects, consider inspecting specific directories
@@ -342,40 +339,38 @@ The inspector opens a web interface where you can:
342
339
> [!NOTE]
343
340
> ✅ **This is no longer an issue!** The server automatically handles this by using isolated configuration directories, allowing inspections to run even when the IDE is already open.
344
341
345
-
346
342
## 📚 Documentation
347
343
348
344
> [!TIP]
349
345
> 🌐 Visit our comprehensive documentation at [josedacosta.github.io/mcp-jetbrains-code-inspections](https://josedacosta.github.io/mcp-jetbrains-code-inspections/)
350
346
351
347
**Available sections:**
352
348
353
-
| Section | Description |
354
-
|---------|-------------|
355
-
| 🏁 **[Getting Started](https://josedacosta.github.io/mcp-jetbrains-code-inspections/getting-started/)**| Installation and prerequisites |
356
-
| ⚙️ **[Configuration](https://josedacosta.github.io/mcp-jetbrains-code-inspections/configuration/)**| Environment variables and profiles |
357
-
| 📖 **[Usage Guide](https://josedacosta.github.io/mcp-jetbrains-code-inspections/usage/)**| Basic and advanced usage |
358
-
| 🔬 **[Technical Details](https://josedacosta.github.io/mcp-jetbrains-code-inspections/technical/)**| Architecture and IDE detection |
359
-
| 💡 **[Guides](https://josedacosta.github.io/mcp-jetbrains-code-inspections/guides/)**| Best practices and troubleshooting |
| 🏁 **[Getting Started](https://josedacosta.github.io/mcp-jetbrains-code-inspections/getting-started/)**| Installation and prerequisites |
352
+
| ⚙️ **[Configuration](https://josedacosta.github.io/mcp-jetbrains-code-inspections/configuration/)**| Environment variables and profiles |
353
+
| 📖 **[Usage Guide](https://josedacosta.github.io/mcp-jetbrains-code-inspections/usage/)**| Basic and advanced usage |
354
+
| 🔬 **[Technical Details](https://josedacosta.github.io/mcp-jetbrains-code-inspections/technical/)**| Architecture and IDE detection |
355
+
| 💡 **[Guides](https://josedacosta.github.io/mcp-jetbrains-code-inspections/guides/)**| Best practices and troubleshooting |
361
356
362
357
## 📖 JetBrains Documentation
363
358
364
359
> [!TIP]
365
360
> Learn more about JetBrains code inspections and the command-line inspector:
366
361
367
-
| Resource | Description |
368
-
|----------|-------------|
369
-
| 📘 **[Code Inspection Overview](https://www.jetbrains.com/help/webstorm/code-inspection.html)**| Learn about code inspections, severity levels, and inspection profiles |
370
-
| 🔧 **[Command-Line Code Inspector](https://www.jetbrains.com/help/webstorm/command-line-code-inspector.html)**| Detailed documentation on using the inspect.sh/inspect.bat tool |
| 📘 **[Code Inspection Overview](https://www.jetbrains.com/help/webstorm/code-inspection.html)**| Learn about code inspections, severity levels, and inspection profiles |
365
+
| 🔧 **[Command-Line Code Inspector](https://www.jetbrains.com/help/webstorm/command-line-code-inspector.html)**| Detailed documentation on using the inspect.sh/inspect.bat tool |
372
366
373
367
## 🤝 Contributing
374
368
375
369
> [!NOTE]
376
370
> We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for full details.
Copy file name to clipboardExpand all lines: docs/deprecated/index.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -35,4 +35,4 @@ You might still need this project if:
35
35
36
36
## Support
37
37
38
-
This project will continue to work but is no longer actively developed. For new features and improvements, please use the native JetBrains MCP integration.
38
+
This project will continue to work but is no longer actively developed. For new features and improvements, please use the native JetBrains MCP integration.
0 commit comments