local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

The MCP server proxies requests from client to JetBrains IDE, allowing tools like Claude Desktop to interface with JetBrains IDEs.

Servidor proxy MCP de JetBrains

El servidor envía las solicitudes del cliente al IDE de JetBrains.

Instalar el complemento del servidor MCP

https://plugins.jetbrains.com/plugin/26071-mcp-server

Uso con Claude Desktop

Para usar esto con Claude Desktop, agregue lo siguiente a su claude_desktop_config.json . La ruta completa en macOS es: ~/Library/Application\ Support/Claude/claude_desktop_config.json ; en Windows, es: %APPDATA%/Claude/claude_desktop_config.json .

{
  "mcpServers": {
    "jetbrains": {
      "command": "npx",
      "args": ["-y", "@jetbrains/mcp-proxy"]
    }
  }
}

Configuración

Si está ejecutando varios IDE con el servidor MCP y desea conectarse a uno específico, agregue a la configuración del servidor MCP:

"env": {
  "IDE_PORT": "<port of IDE's built-in webserver>"
}

De forma predeterminada, nos conectamos al IDE en 127.0.0.1 pero puedes especificar una dirección/host diferente:

"env": {
  "HOST": "<host/address of IDE's built-in webserver>"
}

Para habilitar el registro agregue:

"env": {
  "LOG_ENABLED": "true"
}

Solución de problemas

Requisitos de la versión de Node.js

Problema: Mensaje de error: Cannot find module 'node:path'

Solución: El proxy MCP no funciona en Node 16. Actualice su instalación de Node.js a la versión 18 o posterior. Asegúrese de que el command en la configuración apunte a la versión correcta de Node.js. Intente usar la ruta completa a la última versión de NodeJS.

MacOS: El complemento no puede detectar Node.js instalado a través de NVM

Problema: en MacOS, si tiene Node.js instalado a través de nvm (Node Version Manager), es posible que el complemento del servidor MCP no pueda detectar su instalación de Node.js.

Solución: Cree un enlace simbólico en /usr/local/bin que apunte a su ejecutable nvm npx:

which npx &>/dev/null && sudo ln -sf "$(which npx)" /usr/local/bin/npx

Esta línea única verifica si npx existe en su ruta y crea el enlace simbólico necesario con los permisos adecuados.

Uso de MCP con clientes externos o contenedores Docker (LibreChat, Cline, etc.)

Problema: Al intentar conectarse al proxy MCP de JetBrains desde clientes externos, contenedores Docker o aplicaciones de terceros (como LibreChat), las solicitudes a puntos finales como http://host.docker.internal:6365/api/mcp/list\_tools pueden devolver errores 404 o no poder conectarse. Solución: Hay dos problemas clave que abordar:

Habilitar conexiones externas:

En su IDE JetBrains, habilite "Puede aceptar conexiones externas" en Configuración | Compilación, Ejecución, Implementación | Depurador .

Configurar con IP y puerto LAN:

Utilice la dirección IP LAN de su máquina en lugar de host.docker.internal Establezca explícitamente IDE_PORT y HOST en su configuración. Ejemplo de configuración para LibreChat o clientes externos similares:

mcpServers:
  intellij:
    type: stdio
    command: sh
    args:
      - "-c"
      - "IDE_PORT=YOUR_IDEA_PORT HOST=YOUR_IDEA_LAN_IP npx -y @jetbrains/mcp-proxy"

Reemplazar:

YOUR_IDEA_PORT con el puerto de depuración de su IDE (que se encuentra en la configuración de IDE) YOUR_IDEA_LAN_IP con la IP de red local de su computadora (por ejemplo, 192.168.0.12)

Cómo construir

Probado en macOS
brew install node pnpm
Ejecute pnpm build para compilar el proyecto

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested