JetBrains MCP Server

oficial

Trabaja en tu código con los IDE de JetBrains

Documentación

⚠️ Obsoleto

Este repositorio ya no recibe mantenimiento. La funcionalidad principal se ha integrado en todos los IDE basados en IntelliJ desde la versión 2025.2. La funcionalidad integrada funciona con SSE y proxy basado en JVM (para STDIO), por lo que este paquete NPM ya no es necesario.

Migración: Consulte la documentación oficial para obtener detalles sobre el uso de la funcionalidad integrada.

Problemas y soporte: Para errores o solicitudes de funciones relacionadas con la funcionalidad MCP integrada, utilice JetBrains YouTrack.

Servidor Proxy MCP de JetBrains

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

Instalar el plugin del Servidor MCP

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

Instalación en VS Code

Para una instalación con un solo clic, pulse uno de los botones de instalación siguientes:

Instalación manual

Añada el siguiente bloque JSON a su archivo de Configuración de usuario (JSON) en VS Code. Puede hacerlo pulsando Ctrl + Shift + P y escribiendo Preferences: Open User Settings (JSON).

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

Opcionalmente, puede añadirlo a un archivo llamado .vscode/mcp.json en su espacio de trabajo:

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

Uso con Claude Desktop

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

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

Después de instalar el Plugin del Servidor MCP y añadir el JSON al archivo de configuración, reinicie Claude Desktop y asegúrese de que el producto JetBrains esté abierto antes de reiniciar Claude Desktop.

Configuración

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

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

Por defecto, nos conectamos al IDE en 127.0.0.1, pero puede especificar una dirección/host diferente:

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

Para habilitar el registro, añada:

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

Solución de problemas

Requisitos de 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 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 plugin no puede detectar Node.js instalado mediante nvm

Problema: En MacOS, si tiene Node.js instalado a través de nvm (Node Version Manager), es posible que el Plugin 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 npx de nvm:

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

Este comando de una línea comprueba 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 lograr conectarse. Solución: Hay dos cuestiones clave que abordar:

Habilitar conexiones externas:

En su IDE de JetBrains, habilite "Puede aceptar conexiones externas" en Configuración | Construcción, Ejecución, Despliegue | Depurador.

Configurar con IP de LAN y puerto:

Use la dirección IP de 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"

Reemplace:

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

Cómo compilar

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