Sidecar proxy MCP

versión npm Licencia Publicar en NPM

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

graph LR A[MCP Client e.g. Claude Desktop App] B[MCP Proxy Sidecar with WebSocket] C[JetBrains IDE] D[WebSocket Clients Monitoring] A <--MCP requests/responses--> B B <--IDE commands/responses--> C B --WebSocket notifications port 27042--> D style A fill:#f5f5f5,stroke:#333,stroke-width:2px style B fill:#e1f5fe,stroke:#333,stroke-width:2px style C fill:#f5f5f5,stroke:#333,stroke-width:2px style D fill:#f5f5f5,stroke:#333,stroke-width:2px

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.

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

How are these scores calculated?

local-only server

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

Un servidor MCP de JetBrains modificado que agrega capacidades de monitoreo de WebSocket, lo que permite a los usuarios monitorear las llamadas de herramientas MCP en tiempo real mientras mantienen la compatibilidad con la implementación original.

Related MCP Servers

Superset MCP Integration
aptro
-
security
A
license
-
quality
MCP server enabling AI agents to programmatically connect to and control Apache Superset instances, allowing users to manage dashboards, charts, databases, datasets, and run SQL queries through natural language interactions.
Last updated -
112
MIT License
Shodan MCP Server
X3r0K
-
security
F
license
-
quality
A WebSocket server that provides MCP interface for searching and retrieving information about internet-connected devices, IP addresses, DNS data, and CVE vulnerabilities through the Shodan API.
Last updated -
2
HackathonWatch MCP Server
ag2-mcp-servers
-
security
F
license
-
quality
An MCP server for interacting with the HackathonWatch API, allowing users to access hackathon data and related information through natural language commands.
Last updated -
MCP Server Demo
elvisleyva49
-
security
F
license
-
quality
A minimal WebSocket-based MCP server implementation that enables modern tool integrations with VSCode, Claude, and other applications.
Last updated -
0

View all related MCP servers

MCP Proxy Sidecar