代码智能工具插件

一款JetBrains IDEA插件,通过MCP协议为AI助手(如Claude)提供代码库深度理解功能,实现代码智能辅助开发。

  • by RicterZ
  • Kotlin
  • 本地部署
  • 4 星标
  • 更新于
在 GitHub 查看 RicterZ/IDEA-MCP-Toolkit

使用说明

IDEA MCP工具包

英语| 中文

全面 MCP(模型上下文协议) JetBrains IDEA的插件,它公开了代码智能工具,使像Claude这样的人工智能助手能够直接通过IDE深入理解你的代码库。

特性

工具 说明
initialize_toolkit 先叫这个。 返回使用该工具包的工作流程说明和最佳实践
get_open_in_editor_file_text 阅读当前活动的编辑器选项卡
get_file_text_by_path 按路径(相对、绝对或JAR内部)读取任何文件
list_open_tabs 列出当前打开的所有编辑器选项卡
get_tab_file_text 在不切换焦点的情况下阅读打开的选项卡
find_symbol 按简单或完全限定名查找类/接口/枚举
find_in_files 在项目文件中进行全文搜索(如Cmd+Shift+F)
find_everywhere 搜索类、方法、字段、文件和Spring MVC URL(如双Shift)
get_symbols_overview 在不读取完整内容的情况下获取文件的结构(类、方法、字段)
find_referencing_symbols 查找符号的所有用法(如查找用法)
get_type_hierarchy 获取类或接口的继承链

运作原理

该插件使用内置的Netty服务器在IDEA内运行一个兼容MCP的HTTP+SSE服务器:

  • GET /api/mcp/sse --打开SSE流(MCP传输端点)
  • POST /api/mcp/message?sessionId=xxx --接收JSON-RPC 2.0请求,响应通过SSE流发回

这实现了 MCP 2024-11-05 HTTP+SSE传输 规格。

安装

  1. 构建插件:

    ./gradlew buildPlugin
    

    输出: build/distributions/IDEA-MCP-Toolkit-1.0.5.zip

  2. 在IDEA中: 设置→ 插件→ ⚙️ → 从磁盘安装插件。.. → 选择ZIP

  3. 重新启动IDEA

Claude桌面配置

添加 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "idea": {
      "url": "http://localhost:63342/api/mcp/sse"
    }
  }
}

注: 端口可能会有所不同。检查IDEA的内置服务器端口 设置→ 构建、执行、部署→ 调试器→ 内置服务器.

Claude代码配置

添加 ~/.claude.json (根据 mcpServers 按键):

{
  "mcpServers": {
    "idea": {
      "type": "sse",
      "url": "http://localhost:63342/api/mcp/sse"
    }
  }
}

需求

  • JetBrains创意2024.2+
  • Java 21+
  • 该插件依赖于捆绑的插件: com.intellij.java 和 com.intellij.spring.mvc

发展

# Build plugin ZIP
./gradlew buildPlugin

# Run in sandbox IDEA instance
./gradlew runIde

许可证

麻省理工学院