JetBrains MCP Proxy Server

⚠️ 非推奨

このリポジトリはメンテナンスされなくなりました。 コア機能は、バージョン 2025.2 以降、すべての IntelliJ ベースの IDE に統合されています。 組み込み機能は SSE と JVM ベースのプロキシ（STDIO 用）に対応しているため、この NPM パッケージは不要になりました。

移行： 組み込み機能の使用方法については、公式ドキュメントをご覧ください。

問題とサポート： 組み込みの MCP 機能に関連するバグ報告や機能リクエストは、JetBrains YouTrackをご利用ください。

JetBrains MCP プロキシサーバー

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

MCP サーバープラグインをインストールする

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

VS Code へのインストール

ワンクリックでインストールするには、以下のインストールボタンのいずれかをクリックしてください。

手動でのインストール

以下の JSON ブロックを VS Code のユーザー設定（JSON）ファイルに追加します。Ctrl + Shift + P を押して Preferences: Open User Settings (JSON) と入力すると追加できます。

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

必要に応じて、ワークスペース内の .vscode/mcp.json という名前のファイルに追加することもできます。

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

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 Server Plugin をインストールして JSON を設定ファイルに追加したら、Claude Desktop を再起動します。Claude Desktop を再起動する前に、Jetbrains 製品が開いていることを確認してください。

設定

MCP サーバーを実行する IDE が複数あり、特定の IDE に接続したい場合は、MCP サーバーの設定に以下を追加してください。

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

デフォルトでは IDE の 127.0.0.1 に接続しますが、別のアドレス／ホストを指定することもできます。

"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 以降にアップグレードしてください。設定内の command が正しいバージョンの Node.js を指していることを確認してください。 NodeJS の最新バージョンへのフルパスを使用してください。

MacOS：nvm でインストールした Node.js をプラグインが検出できない

問題： MacOS で nvm（Node Version Manager）経由で Node.js をインストールしている場合、MCP Server Plugin が Node.js のインストールを検出できないことがあります。

解決方法： /usr/local/bin に、nvm の npx 実行ファイルを指すシンボリックリンクを作成してください。

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

このワンライナーは、パス内に npx が存在するか確認し、適切な権限で必要なシンボリックリンクを作成します。

外部クライアントまたはDockerコンテナでMCPを使用する（LibreChat、Clineなど）

問題： 外部クライアント、Dockerコンテナ、またはサードパーティ製アプリケーション（LibreChatなど）からJetBrains MCPプロキシに接続しようとすると、http://host.docker.internal:6365/api/mcp/list_tools などのエンドポイントへのリクエストで404エラーが返されたり、接続に失敗したりすることがあります。 解決方法： 対処が必要な主な問題は2つあります。

1. 外部接続を有効にする：

JetBrains IDEで、Settings | Build, Execution, Deployment | Debugger の「Can accept external connections」を有効にします。

2. 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 を実行してプロジェクトをビルドします