JetBrains代码检查服务

🔍 MCP JetBrains代码检查

[！小心]

⚠️ 废弃通知

此项目已弃用，但仍在运行。 从2025.2版本开始，JetBrains IDE（WebStorm、IntelliJ IDEA、PyCharm等）现在包括一个内置的MCP服务器，该服务器提供与外部客户端（如Claude Desktop、Cursor、VS Code等）的本地集成。

🔄 迁移选项

IDE版本	推荐解决方案	链接
2025.2+	内置MCP服务器	官方文件
早期版本	JetBrains MCP插件	插件市场

✅ 本地集成优势

• 直接IDE控制 无需外部工具
• 25+工具 综合工具集
• 更好的性能 以及可靠性
• 官方支持 来自JetBrains

[！重要] 本地人 get_file_problems 工具需要设置 errorsOnly: false 用于与此项目类似的功能。这 get_project_problems 该工具仅返回关键错误。

📚 查看迁移指南和比较→

A. 模型上下文协议（MCP） 该服务器为JetBrains IDE代码检查提供自动IDE选择和跨所有文件类型的统一检查配置文件。

[！提示] 📚 完整文档可用：请访问我们的综合文档 josedacosta.github.io/mcp-jetbrains代码检查

🎯 快速开始

[！注意] 在2分钟内开始！

# Clone the repository
git clone https://github.com/josedacosta/mcp-jetbrains-code-inspections.git
cd mcp-jetbrains-code-inspections

# Install and build
yarn install && yarn build

# Test with MCP Inspector
yarn inspect

然后使用以下命令配置MCP客户端（Claude Desktop、Cursor等） 配置如下.

✨ 特性

📦 安装

[！注意] 先决条件：Node.js≥20，安装了JetBrains IDE

逐步安装

1. 安装依赖项:

   复制

   yarn install
   

2. 构建服务器:

   复制

   yarn build
   

3. 配置MCP （参见 ⚙️ 配置 下节）

[！提示] 使用 yarn inspect 安装后，使用MCP检查器测试服务器

🚀 用法

📚 MCP功能

服务器提供三种类型的MCP功能：

🔨 工具

• get_getbrains_code检查：对指定的文件或目录运行代码检查

💬 提示

• 分析项目：分析项目的代码质量问题
• 检查文件：检查特定文件中的问题
• 修复问题：获取解决检测到的问题的建议

📚 资源

• 我nspection://profiles：可用检查配置文件列表
• 我nspection://config：当前MCP服务器配置
• 我nspection://ides：系统上检测到的JetBrains IDE列表

🏃 运行服务器

[！提示] 为了开发，使用 yarn dev 这包括热重新加载以实现更快的迭代。

# 🔄 Run in development mode (with hot-reload)
yarn dev

# 📦 Run the built server (production)
yarn start

# 🧪 Use MCP Inspector for interactive testing
yarn inspect

⚙️ 配置

代码检查服务器可以通过以下环境变量进行配置 .mcp.json:

{
    "mcpServers": {
        "mcp-jetbrains-code-inspections": {
            "command": "node",
            "args": ["./dist/index.js"],
            "env": {
                "EXCLUDE_INSPECTIONS": "SpellCheckingInspection"
            }
        }
    }
}

📝 可用参数

🔧 刀具参数（必填）

[！重要] 该工具只接受LLM中的一个参数：

🌍 通过环境变量进行配置

[！注意] 所有配置都通过中的环境变量进行管理 .mcp.json这些设置控制检查服务器的操作方式。

[！提示] 📚 有关详细的配置选项，请参阅 配置文档.

🧪 测试

1.️⃣ 交互式MCP测试

yarn test:mcp

这将运行一个交互式测试，允许您直接测试MCP服务器功能。

2.️⃣ MCP检查员测试（推荐）

# Launch the inspector (no installation needed)
yarn inspect

# Or for development mode with hot reload
yarn inspect:dev

检查器打开一个web界面，您可以在其中：

• 查看可用的工具、提示和资源
• 交互式测试get_getbrains_code_inspections工具
• 对常见任务使用预先配置的提示
• 访问服务器资源（配置文件、配置、检测到的IDE）
• 实时查看请求/响应

⚙️ 运作原理

🎯 自动IDE选择

[！注意] 服务器智能地检测并为您的项目选择最合适的JetBrains IDE。

优先级顺序：

1. 智能 IDEA -终极Java/Kotlin集成开发环境
2. WebStorm -JavaScript/TypeScript专家
3. PyCharm 的 -Python开发
4. 暴风雪 -PHP开发
5. 戈兰 -Go编程
6. 骑手 - .NET开发
7. CLion -C/C++开发
8. RubyMine -Ruby/Rails
9. DataGraph -数据库管理
10. DataSpell -数据科学
11. AppCode -iOS/macOS开发

[！提示] 使用 FORCE_INSPECT_PATH 以覆盖自动检测并指定特定的IDE。

🔒 隔离配置

[！重要] 关键创新：服务器使用临时隔离的配置目录 -Didea.config.path 和 -Didea.system.path JVM属性。这使得即使IDE已经打开，检查也可以运行！

优点：

• ✅ 没有IDE冲突
• ✅ 并行执行支持
• ✅ 清洁、隔离的分析
• ✅ 不会干扰您的活动IDE会话

💻 输出示例

🔍 Searching for available JetBrains IDE inspect tools...
   Following priority order: IntelliJ IDEA > WebStorm > PyCharm > PhpStorm > GoLand > ...

   ✅ WebStorm - Found and selected!
      Path: /Applications/WebStorm.app/Contents/bin/inspect.sh
      Note: Using isolated configuration - works even if IDE is already running

📊 Analysis Results:
   ⚠️ Warning: Unused variable 'config' at line 42
   ❌ Error: Missing semicolon at line 156
   💡 Info: Consider using const instead of let at line 78

🛠️ 故障排除

❌ “未找到JetBrains IDE检查工具”

[！警告] 当在标准安装位置找不到JetBrains IDE时，会发生此错误。

解决：

• ✅ 验证是否已在中安装JetBrains IDE /Applications/ 或 ~/Applications/
• ✅ 确保 inspect.sh 文件是可执行的
• ✅ 使用 FORCE_INSPECT_PATH 用于指定确切路径的环境变量

⚠️ “未找到检查配置文件”

[！小心] 没有检查配置文件，该工具无法正确分析您的代码。

修复步骤：

1. 在JetBrains IDE中打开项目
2. 首选 设置 → 检查
3. 配置并保存检查配置文件
4. 或者，使用 FORCE_PROFILE_PATH 指定自定义配置文件

⏱️ 超时问题

[！提示] 默认超时为120秒。大型项目可能需要更多时间。

解决：

• 🔄 增加超时时间：设置 INSPECTION_TIMEOUT=300000 （5分钟）
• 📊 检查IDE当前是否没有索引
• 📦 对于非常大的项目，考虑检查特定的目录

🚫 “一次只能运行一个实例”

[！注意] ✅ 这已经不是问题了！ 服务器通过使用隔离的配置目录自动处理此问题，即使IDE已经打开，也允许检查运行。

📚 文档

[！提示] 🌐 请访问我们的综合文档 josedacosta.github.io/mcp-jetbrains代码检查

可用部分：

📖 JetBrains文档

[！提示] 了解有关JetBrains代码检查和命令行检查器的更多信息：

🤝 贡献

[！注意] 我们欢迎捐款！请查看我们的 贡献指南 了解全部细节。

我们正在寻找的内容：

• 🐛 Bug修复和问题报告
• ✨ 新功能和增强功能
• 📝 文档改进
• 🧪 测试覆盖范围扩展
• 🌍 语言/IDE支持

🚀 贡献者快速入门

[！重要] 我们跟随 常规承诺 并使用GitHub Flow。

# 1. Fork and clone the repository
git clone https://github.com/YOUR-USERNAME/mcp-jetbrains-code-inspections.git

# 2. Create a feature branch
git checkout -b feat/amazing-feature

# 3. Make your changes and commit
git commit -m 'feat(scope): add amazing feature'

# 4. Push to your fork
git push origin feat/amazing-feature

# 5. Open a Pull Request

[！提示] 看 贡献.md 用于分支命名、提交消息标准和PR指南。

🏷️ 关键词

由以下材料制成❤️ Runtima团队