JetBrains MCP Server

oficial

Trabalhe no seu código com IDEs JetBrains

Documentação

⚠️ Descontinuado

Este repositório não é mais mantido. A funcionalidade principal foi integrada em todas as IDEs baseadas no IntelliJ desde a versão 2025.2. A funcionalidade integrada funciona com SSE e proxy baseado em JVM (para STDIO), portanto este pacote NPM não é mais necessário.

Migração: Consulte a documentação oficial para obter detalhes sobre o uso da funcionalidade integrada.

Problemas e Suporte: Para bugs ou solicitações de recursos relacionados à funcionalidade MCP integrada, utilize o JetBrains YouTrack.

Servidor Proxy JetBrains MCP

O servidor faz proxy de requisições do cliente para a IDE JetBrains.

Instalar o plugin MCP Server

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

Instalação no VS Code

Para instalação com um clique, clique em um dos botões de instalação abaixo:

Instalação Manual

Adicione o seguinte bloco JSON ao seu arquivo de Configurações do Usuário (JSON) no VS Code. Você pode fazer isso pressionando Ctrl + Shift + P e digitando Preferences: Open User Settings (JSON).

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

Opcionalmente, você pode adicioná-lo a um arquivo chamado .vscode/mcp.json no seu espaço de trabalho:

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

Uso com Claude Desktop

Para usar com o Claude Desktop, adicione o seguinte ao seu claude_desktop_config.json. O caminho completo no MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json, no Windows: %APPDATA%/Claude/claude_desktop_config.json.

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

Após instalar o Plugin MCP Server e adicionar o JSON ao arquivo de configuração, reinicie o Claude Desktop e certifique-se de que o produto JetBrains esteja aberto antes de reiniciar o Claude Desktop.

Configuração

Se você estiver executando várias IDEs com o servidor MCP e quiser se conectar a uma específica, adicione à configuração do servidor MCP:

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

Por padrão, conectamos à IDE em 127.0.0.1, mas você pode especificar um endereço/host diferente:

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

Para habilitar o registro de logs, adicione:

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

Solução de Problemas

Requisitos de Versão do Node.js

Problema: Mensagem de erro: Cannot find module 'node:path'

Solução: O MCP Proxy não funciona no Node 16. Atualize sua instalação do Node.js para a versão 18 ou posterior. Certifique-se de que command na configuração aponte para a versão correta do Node.js. Tente usar o caminho completo para a versão mais recente do NodeJS.

MacOS: Plugin Não Consegue Detectar Node.js Instalado via nvm

Problema: No MacOS, se você tiver o Node.js instalado através do nvm (Node Version Manager), o Plugin MCP Server pode não conseguir detectar sua instalação do Node.js.

Solução: Crie um link simbólico em /usr/local/bin apontando para o executável npx do seu nvm:

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

Este comando de uma linha verifica se o npx existe no seu path e cria o link simbólico necessário com as permissões adequadas.

Usando MCP com Clientes Externos ou Contêineres Docker (LibreChat, Cline, etc.)

Problema: Ao tentar conectar ao proxy JetBrains MCP a partir de clientes externos, contêineres Docker ou aplicações de terceiros (como LibreChat), as requisições para endpoints como http://host.docker.internal:6365/api/mcp/list_tools podem retornar erros 404 ou falhar na conexão. Solução: Existem dois pontos principais a abordar:

Habilitar Conexões Externas:

Na sua IDE JetBrains, habilite "Can accept external connections" em Settings | Build, Execution, Deployment | Debugger.

Configurar com IP da LAN e Porta:

Use o endereço IP da LAN da sua máquina em vez de host.docker.internal Defina explicitamente IDE_PORT e HOST na sua configuração Exemplo de configuração para LibreChat ou 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"

Substitua:

YOUR_IDEA_PORT pela porta de depuração da sua IDE (encontrada nas configurações da IDE) YOUR_IDEA_LAN_IP pelo IP da rede local do seu computador (ex.: 192.168.0.12)

Como compilar

Testado no macOS
brew install node pnpm
Execute pnpm build para compilar o projeto