mcp-jetbrains-ide

star 1.2k

Control JetBrains IDE (IntelliJ, WebStorm, PyCharm) via MCP. Use when manipulating IDE files, running configurations, searching code, or performing refactoring. Triggers on "open in IDE", "run configuration", "refactor code", "IDE search", "JetBrains".

Dicklesworthstone By Dicklesworthstone schedule Updated 2/5/2026

name: mcp-jetbrains-ide description: Control JetBrains IDE (IntelliJ, WebStorm, PyCharm) via MCP. Use when manipulating IDE files, running configurations, searching code, or performing refactoring. Triggers on "open in IDE", "run configuration", "refactor code", "IDE search", "JetBrains".

JetBrains IDE Integration

MCP service at http://localhost:64342/sse (sse) with 22 tools.

Requirements

  • mh CLI must be installed. If not available, install with:
    curl -fsSL https://raw.githubusercontent.com/vaayne/mcphub/main/scripts/install.sh | sh
    
  • JetBrains IDE must be running with MCP plugin enabled

Usage

List tools: mh -u http://localhost:64342/sse -t sse list Get tool details: mh -u http://localhost:64342/sse -t sse inspect <tool-name> Invoke tool: mh -u http://localhost:64342/sse -t sse invoke <tool-name> '{"param": "value"}'

Notes

  • Run inspect before invoking unfamiliar tools to get full parameter schema
  • Timeout: 30s default, use --timeout <seconds> to adjust
  • SSE port may vary - check IDE MCP plugin settings if connection fails
  • All file paths are relative to project root unless absolute

Tools

File Operations

Tool Description
createNewFile Create a new file at specified path, auto-creates parent directories
getFileTextByPath Read file contents by project-relative path
replaceTextInFile Replace text in file with flexible find/replace options
reformatFile Apply code formatting rules to a file
openFileInEditor Open a file in the IDE editor
getAllOpenFilePaths Get paths of all currently open files

Search

Tool Description
findFilesByNameKeyword Find files by name keyword (case-insensitive)
findFilesByGlob Find files matching glob pattern (e.g. **/*.ts)
searchInFilesByText Search for text substring across project files
searchInFilesByRegex Search with regex pattern across project files

Code Intelligence

Tool Description
getSymbolInfo Get documentation/info about symbol at position
getFileProblems Analyze file for errors and warnings
renameRefactoring Rename symbol across entire project

Project

Tool Description
listDirectoryTree Tree view of directory structure
getProjectModules List all project modules with types
getProjectDependencies List all project dependencies
getRepositories List VCS roots in project

Execution

Tool Description
getRunConfigurations List available run configurations
executeRunConfiguration Run a specific run configuration
executeTerminalCommand Execute shell command in IDE terminal

Other

Tool Description
permissionPrompt Permission prompt utility

Examples

# List project structure
mh -u http://localhost:64342/sse -t sse invoke listDirectoryTree '{"path": "."}'

# Search for text in files
mh -u http://localhost:64342/sse -t sse invoke searchInFilesByText '{"query": "TODO"}'

# Read a file
mh -u http://localhost:64342/sse -t sse invoke getFileTextByPath '{"path": "src/index.ts"}'

# Rename a symbol
mh -u http://localhost:64342/sse -t sse invoke renameRefactoring '{"path": "src/utils.ts", "line": 10, "column": 5, "newName": "newFunctionName"}'

# Run a configuration
mh -u http://localhost:64342/sse -t sse invoke executeRunConfiguration '{"name": "Run Tests"}'
Install via CLI
npx skills add https://github.com/Dicklesworthstone/pi_agent_rust --skill mcp-jetbrains-ide
Repository Details
star Stars 1,182
call_split Forks 140
navigation Branch main
article Path SKILL.md
More from Creator
Dicklesworthstone
Dicklesworthstone Explore all skills →