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

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

構成

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 ProxyはNode 16では動作しません。Node.jsをバージョン18以降にアップグレードしてください。config commandが正しいNode.jsバージョンを指していることを確認してください。最新バージョンのNode.jsへのフルパスを使用してみてください。

MacOS: プラグインが nvm 経由でインストールされた Node.js を検出できない

問題: MacOS で、nvm (Node Version Manager) を介して Node.js がインストールされている場合、MCP サーバー プラグインは Node.js のインストールを検出できない可能性があります。

解決策: nvm npx 実行可能ファイルを指すシンボリック リンクを/usr/local/binに作成します。

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エラーが返されたり、接続に失敗したりすることがあります。**解決策:**対処すべき重要な問題が2つあります。

  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実行してプロジェクトをビルドします
-
security - not tested
A
license - permissive license
-
quality - not tested

サーバーはクライアントからのリクエストを JetBrains IDE にプロキシします。

  1. Install MCP Server plugin
    1. Usage with Claude Desktop
      1. Configuration
        1. Troubleshooting
          1. Node.js Version Requirements
          2. MacOS: Plugin Unable to Detect Node.js Installed via nvm
          3. Using MCP with External Clients or Docker Containers (LibreChat, Cline, etc.)
        2. How to build
          ID: k7xzbtlxvb