Install
npx -y @jetbrains/mcp-proxyPara quem
Para quem ainda usa uma IDE JetBrains antiga e precisa proxyar pedidos de um cliente MCP até a IDE. A evidência afirma: este servidor faz proxy dos pedidos do cliente para uma IDE JetBrains.
Mas este repositório não é mais mantido. A capacidade central está integrada desde 2025.2 em todas as IDEs baseadas em IntelliJ: SSE embutido e um proxy JVM para STDIO, então este pacote NPM não é mais necessário. Se a IDE já é 2025.2 ou mais nova, não instale este pacote.
Siga só se ainda precisar explicitamente do caminho NPM histórico. Também precisa do plugin MCP Server, e o Node.js deve ser 18 ou superior. A evidência não lista produtos cliente; o recorte para em «JetBrains IDE».
Primeira tentativa em 3 minutos
Se IDE ≥ 2025.2: o caminho principal é o MCP embutido da IDE (SSE / proxy JVM STDIO). Pare aí; não execute o npx abaixo.
Se ainda usa este pacote, configure:
"command": "npx",
"args": ["-y", "@jetbrains/mcp-proxy"]
E instale o plugin: https://plugins.jetbrains.com/plugin/26071-mcp-server
Pré-requisitos: a IDE está aberta; o plugin está instalado; Node 18+ (Node 16 lança Cannot find module 'node:path'). O proxy liga por padrão à IDE em 127.0.0.1 e toca a IDE e o projeto locais — não é um arranjo sem leitura local.
Onde configurar: command / args do MCP do cliente. Se várias IDEs estiverem abertas, acrescente também:
"env": {
"IDE_PORT": "<port of IDE's built-in webserver>"
}
Primeira chamada de baixo risco: um pedido de conectividade para o cliente perguntar à IDE, via proxy, informação somente leitura do projeto atual (por exemplo, qual projeto está aberto). A evidência não nomeia ferramentas nem parâmetros. Não comece editando arquivos, rodando um build ou fazendo escritas na IDE.
Sinal de sucesso: o processo proxy sobe e o cliente deixa de dizer que não alcança a IDE; com várias abertas, IDE_PORT aponta para a que você escolheu. Se ainda for à instância errada, mude primeiro a porta; não assuma que o padrão está certo.
Casos de uso
Caso 1: ligar um cliente MCP a uma única IDE em execução. Use o 127.0.0.1 padrão e a config npx acima (ou o embutido em 2025.2+). A evidência só garante «fazer proxy dos pedidos até a IDE» e não lista ferramentas. O que se confirma: o pedido chegou à IDE local.
Caso 2: várias IDEs com MCP estão abertas e você quer fixar uma. Adicione IDE_PORT na config. A evidência também diz que se pode indicar outro address/host, mas o locator corta em «specify a different address/host:» e não dá o nome da variável de ambiente. Só IDE_PORT é o método de escolha comprovado; não invente variável de host.
Limites de uso
O repositório não é mais mantido; em 2025.2+ use a capacidade embutida. O caminho histórico depende de @jetbrains/mcp-proxy, do plugin MCP Server e de Node 18+. Por padrão só liga ao 127.0.0.1 local. Não há nomes de ferramentas, modelo de permissão nem undo oficial. Fazer proxy dos pedidos até a IDE expõe o projeto e as capacidades da IDE a esse cliente. A evidência não diz como consultar a porta nem os passos de segurança para exposição não local.