proyecto oficial de JetBrains

Servidor proxy MCP de JetBrains

Name: mcp-jetbrains
Author: 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

Related MCP server: Code Analysis 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)