mcp-jetbrains-ide

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"}'