lumerix7/jetbrains-proxy-mcp-server

JetBrains Proxy MCP Server

Project Overview:

• A Python-based proxy server for the JetBrains MCP (Model Context Protocol) server that acts as an intermediary between an MCP client and a JetBrains MCP server.
• The core logic resides in , which handles the proxy server setup and transport layer. The class manages the connection to the downstream JetBrains MCP server and proxies the tool calls. It also includes logic to handle path conversions between different path formats (WSL, Git Bash, Windows).

Configuration is managed through the class, which loads settings from a config.yaml file.

Features:

• Proxy Functionality: Forwards requests from MCP clients to the JetBrains MCP server
• Dual Transport Support: Works with both Server-Sent Events (SSE) and standard I/O (stdio)
• Path Conversion: Handles file path conversions between different path formats (WSL, Git Bash, Windows)
• Resilience: Built-in retry, timeout, and restart mechanisms for robust operation
• Tool Filtering: Supports a curated list of JetBrains tools for controlled access

Installation

See

Usage: pytools.sh <command> [args...]

Commands:
  test [pytest-args...]             Always run pytest in project .venv (auto-create). If pytest missing, auto-install.
  purge                             Remove temp/build files (.venv, build, dist, caches, *.egg-info, _version.py)
  reinstall-system [pip-args...]    Reinstall into SYSTEM Python. Pass extra args to 'pip install'. No purge.
                                    Examples:
                                      pytools.sh reinstall-system --break-system-packages
                                      pytools.sh reinstall-system --no-build-isolation ".[dev]"
  reinstall-venv [pip-args...]      Reinstall into project .venv (auto-create). Pass extra args to 'pip install'. No purge.
                                    Examples:
                                      pytools.sh reinstall-venv
                                      pytools.sh reinstall-venv --no-build-isolation ".[dev]"
  upload <repository> [extra-pip-args...]  Build (sdist+wheel) and upload via twine to the named repository (e.g. pypi, testpypi).
                                    Pass extra args to 'pip install' after the default list.
                                    Examples:
                                      pytools.sh upload pypi
                                      pytools.sh upload testpypi 'build==1.2.2' 'twine==5.0.0'

Env vars:
  PYTHON_BIN   Python command to use (default: python3)
  VENV_DIR     Virtualenv path (default: $script_dir/.venv)

# Install the package using the provided script:
./pytools.sh reinstall-venv

./pytools.sh reinstall-system --break-system-packages

# Or install the package using pip:
pip install .

Configuration

See also:

Create a config.yaml file to configure the proxy server. The server will look for this file in the following order:

1. Path specified by the --config command line argument
2. config.yaml in the current directory
3. ~/.config/jetbrains-proxy-mcp-server/config.yaml

Example Configuration

# Server configuration
server-name: "JetBrains Proxy MCP Server"
transport: "sse"  # or "stdio"
timeout: 60.0

sse-port: 41110
sse-debug-enabled: true

# JetBrains MCP server configuration
jetbrains-mcp-server:
  name: "jetbrains-mcp-server"
  url: "http://127.0.0.1:64342/sse"
  timeout: 35.0
  sse-read-timeout: 300.0
  start-timeout: 120.0
  stop-timeout: 30.0
  max-attempts: 5
  initial-backoff: 1.0
  max-backoff: 60.0
  backoff-multiplier: 3.0
  debug-enabled: true
  client-path-type: "wsl"  # or ""windows_git_bash" or "windows"
  server-path-type: "windows"  # or "wsl" or "windows_git_bash"

Environment Variables

See also:

Configuration can also be set using environment variables:

• JETBRAINS_PROXY_MCP_SERVER_CONFIG - Path to config file
• JETBRAINS_PROXY_MCP_SERVER_NAME - Server name
• JETBRAINS_PROXY_MCP_SERVER_TRANSPORT - Transport type
• JETBRAINS_PROXY_MCP_SERVER_TIMEOUT - Tool timeout

For stdio transport, you must set:

export SIMP_LOGGER_LOG_CONSOLE_ENABLED=False

MCP Configuration

JSON

sse, wsl:

{
  "mcpServers": {
    "jetbrains": {
      "url": "http://127.0.0.1:41110/sse"
    }
  }
}

sse, windows:

{
  "mcpServers": {
    "jetbrains": {
      "url": "http://127.0.0.1:41111/sse"
    }
  }
}

stdio, windows:

pip install jetbrains-proxy-mcp-server --upgrade --force-reinstall --extra-index-url http://127.0.0.1:8081/repository/pypi-group/simple --trusted-host 127.0.0.1

{
  "mcpServers": {
    "jetbrains": {
      "command": "jetbrains-proxy-mcp-server",
      "args": [
        "--config",
        "c:/Users/<USER>/.config/jetbrains-proxy-mcp-server/config.yaml"
      ],
      "env": {
        "SIMP_LOGGER_LOG_CONSOLE_ENABLED": "False",
        "SIMP_LOGGER_LOG_LEVEL": "DEBUG"
      }
    }
  }
}

Running the Server

Start the server with:

jetbrains-proxy-mcp-server

# Or:
jetbrains-proxy-mcp-server --config /path/to/your/config.yaml

If no config path is provided, the server will search for a config.yaml file in the default locations.

Supported Tools

The proxy supports a curated list of JetBrains tools:

MCP Server v252.xxx

• get_all_open_file_paths - Get paths of all open files
• get_file_problems - Analyze file for errors and warnings
• get_file_text_by_path - Retrieve text content of a file
• get_project_dependencies - Get project dependencies
• get_project_modules - Get project modules
• get_project_problems - Get project-wide problems
• list_directory_tree - List directory contents in tree format
• reformat_file - Reformat a file
• rename_refactoring - Rename a symbol across the project
• replace_text_in_file - Replace text in a file
• search_in_files_by_regex - Search files using regex
• search_in_files_by_text - Search files for text

Path Conversion

The proxy handles path conversions between different operating systems:

• WSL: /mnt/c/path/to/file
• Git Bash: /c/path/to/file
• Windows: C:\path\to\file

Configure client-path-type and server-path-type in your config to match your environments.

Development

Development Conventions

• The project uses setuptools for packaging.
• Dependencies are managed in pyproject.toml.
• The code follows standard Python conventions.
• Logging is implemented using the logging module.
• The project uses anyio for asynchronous operations.
• The server uses uvicorn when running with the SSE transport.

Installing dependencies

To install the necessary dependencies, run:

uv sync --no-install-project --extra test

Testing

Run tests with pytest:

./pytools test tests/test_xxx.py

# Or use the command directly:
pytest tests/test_xxx.py

# Or test all:
pytest

Dependencies

• Python >= 3.10
• mcp >= 1.4.0
• pydantic >= 2.0
• typing >= 3.7.4.3
• pyyaml >= 6.0.2
• anyio >= 4.3.0

License

This project is licensed under the MIT License. See the file for details.