mcp-jetbrains

Official

local-only server

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

Integrations

  • The MCP server proxies requests from client to JetBrains IDE, allowing tools like Claude Desktop to interface with JetBrains IDEs.

JetBrains MCP 프록시 서버

서버는 클라이언트의 요청을 JetBrains IDE로 프록시합니다.

MCP 서버 플러그인 설치

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

Claude Desktop과 함께 사용

Claude Desktop에서 이 기능을 사용하려면 claude_desktop_config.json 파일에 다음을 추가하세요. MacOS의 전체 경로는 ~/Library/Application\ Support/Claude/claude_desktop_config.json 이고, Windows의 전체 경로는 %APPDATA%/Claude/claude_desktop_config.json .

지엑스피1

구성

MCP 서버로 여러 IDE를 실행하고 특정 IDE에 연결하려면 MCP 서버 구성에 다음을 추가하세요.

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

기본적으로 127.0.0.1에서 IDE에 연결하지만 다른 주소/호스트를 지정할 수 있습니다.

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

로깅을 활성화하려면 다음을 추가하세요.

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

문제 해결

Node.js 버전 요구 사항

문제: 오류 메시지: Cannot find module 'node:path'

해결 방법: MCP 프록시가 Node 16에서 작동하지 않습니다. Node.js 설치를 18 이상으로 업그레이드하세요. 설정 파일의 해당 command 올바른 Node.js 버전을 가리키는지 확인하세요. 최신 Node.js 버전의 전체 경로를 사용해 보세요.

MacOS: 플러그인이 nvm을 통해 설치된 Node.js를 감지할 수 없음

문제: MacOS에서 nvm(Node Version Manager)을 통해 Node.js를 설치한 경우, MCP 서버 플러그인이 Node.js 설치를 감지하지 못할 수 있습니다.

해결 방법: /usr/local/bin 에 nvm npx 실행 파일을 가리키는 심볼릭 링크를 만듭니다.

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

이 한 줄 명령어는 npx가 경로에 있는지 확인하고 적절한 권한으로 필요한 심볼릭 링크를 만듭니다.

외부 클라이언트 또는 Docker 컨테이너(LibreChat, Cline 등)와 함께 MCP 사용

문제: 외부 클라이언트, Docker 컨테이너 또는 타사 애플리케이션(예: LibreChat)에서 JetBrains MCP 프록시에 연결하려고 할 때 http://host.docker.internal:6365/api/mcp/list\_tools 와 같은 엔드포인트에 대한 요청이 404 오류를 반환하거나 연결에 실패할 수 있습니다. 해결책: 해결해야 할 두 가지 주요 문제는 다음과 같습니다.

  1. 외부 연결 활성화:

JetBrains IDE에서 설정 | 빌드, 실행, 배포 | 디버거 에서 "외부 연결 허용"을 활성화합니다.

  1. LAN IP 및 포트로 구성:

host.docker.internal 대신 컴퓨터의 LAN IP 주소를 사용하세요. 구성에서 IDE_PORT와 HOST를 명시적으로 설정하세요. LibreChat 또는 유사한 외부 클라이언트에 대한 구성 예:

mcpServers: intellij: type: stdio command: sh args: - "-c" - "IDE_PORT=YOUR_IDEA_PORT HOST=YOUR_IDEA_LAN_IP npx -y @jetbrains/mcp-proxy"

바꾸다:

YOUR_IDEA_PORT 는 IDE 설정에서 찾을 수 있는 IDE 디버그 포트이고, YOUR_IDEA_LAN_IP 는 컴퓨터의 로컬 네트워크 IP(예: 192.168.0.12)입니다.

어떻게 구축하는가

  1. macOS에서 테스트됨
  2. brew install node pnpm
  3. pnpm build 실행하여 프로젝트를 빌드합니다.
ID: k7xzbtlxvb