Sidecar proxy MCP

Una bifurcación del servidor MCP de JetBrains que agrega capacidades de monitoreo de WebSocket, creado por @dortegau .

Este proyecto amplía la funcionalidad del servidor MCP original con soporte WebSocket manteniendo la compatibilidad con todas las características de la implementación original.

Arquitectura

El diagrama anterior ilustra la arquitectura del sistema y el flujo de datos:

Los clientes MCP (como la aplicación de escritorio Claude) se comunican con Sidecar mediante el protocolo MCP
El Sidecar traduce y reenvía comandos a JetBrains IDE
Las respuestas del IDE se envían de vuelta a través del Sidecar
Todas las llamadas a herramientas se transmiten a través de WebSocket para fines de monitoreo.

Características

Esta bifurcación añade notificaciones de WebSocket que permiten supervisar todas las llamadas a herramientas MCP en tiempo real. Cada llamada a herramienta se transmite a través de WebSocket con información detallada sobre el endpoint y los argumentos.

Formato de mensaje de WebSocket

interface MCPNotification {
  type: 'mcp-notification';
  payload: {
    endpoint: string;     // Tool name that was called
    content: any;         // Call arguments
    timestamp: string;    // ISO timestamp
  }
}

Configuración de WebSocket

El servidor WebSocket se ejecuta en el puerto 27042 de forma predeterminada. Puede personalizar este puerto mediante la variable de entorno WS_PORT en su configuración:

"env": {
  "WS_PORT": "<custom port number>"  // Example: "8080"
}

Uso

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": {
    "ide": {
      "command": "npx",
      "args": ["-y", "mcp-proxy-sidecar"],
      "env": {
        "WS_PORT": "27042"  // Optional: customize WebSocket port
      }
    }
  }
}

Opciones de configuración

Las siguientes variables de entorno se pueden configurar en su claude_desktop_config.json :

Variable	Descripción	Por defecto
`WS_PORT`	Puerto para servidor WebSocket	`27042`
`IDE_PORT`	Puerto específico para conexión IDE	Escaneos automáticos 63342-63352
`HOST`	Dirección de host para la conexión IDE	`127.0.0.1`
`LOG_ENABLED`	Habilitar el registro de depuración	`false`

Ejemplo de configuración con todas las opciones:

{
  "mcpServers": {
    "ide": {
      "command": "npx",
      "args": ["-y", "mcp-proxy-sidecar"],
      "env": {
        "WS_PORT": "27042",
        "IDE_PORT": "63342",
        "HOST": "127.0.0.1",
        "LOG_ENABLED": "true"
      }
    }
  }
}

Nota: Si no se especifica IDE_PORT , el sidecar escaneará automáticamente los puertos 63342-63352 para encontrar el IDE.

Desarrollo

Requisitos

Node.js 20.x
pnpm (última versión)

Construir

Instalar dependencias:
pnpm install --frozen-lockfile
Construir el proyecto:
pnpm build

Contribuyendo

Bifurcar el repositorio
Crea tu rama de funciones ( git checkout -b feature/amazing-feature )
Confirme sus cambios ( git commit -m 'Add some amazing feature' )
Empujar a la rama ( git push origin feature/amazing-feature )
Abrir una solicitud de extracción

Publicación

Este paquete se publica en npm con:

Procedencia habilitada para la seguridad de la cadena de suministro
Lanzamientos automatizados a través de Acciones de GitHub al crear un nuevo lanzamiento
Acceso público al registro npm

Para publicar una nueva versión:

Actualizar la versión en package.json
Crea y envía una nueva etiqueta que coincida con la versión
Crear un lanzamiento de GitHub desde la etiqueta
El flujo de trabajo se creará y publicará automáticamente en npm

Registro de cambios

1.0.0

Bifurcación inicial de @jetbrains/mcp-proxy
Se agregó compatibilidad con WebSocket para la monitorización de llamadas a herramientas en tiempo real
Paquete renombrado para mayor claridad
Documentación actualizada y ejemplos de configuración

Créditos

Esta es una bifurcación del servidor proxy MCP de JetBrains . Todo el crédito por la implementación original corresponde al equipo de JetBrains.

MCP Proxy Sidecar

Integrations