JetBrains

⚠️ 非推奨

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

移行: 組み込み機能の使用に関する詳細は、公式ドキュメントを参照してください。

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

JetBrains MCP プロキシサーバー

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

MCP Server プラグインのインストール

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

VS Code のインストール

ワンクリックインストールの場合は、以下のインストールボタンのいずれかをクリックしてください:

手動インストール

VS Codeのユーザー設定（JSON）ファイルに以下の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 プラグインをインストールし、設定ファイルにJSONを追加した後、Claude Desktopを再起動してください。再起動前にJetBrains製品が開いていることを確認してください。

設定

複数のIDEでMCPサーバーを実行していて、特定の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バージョンを指していることを確認してください。 最新バージョンのNodeJSへのフルパスを使用してみてください。

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

問題: MacOSで、nvm（Node Version Manager）を通じてNode.jsをインストールしている場合、MCP Server プラグインが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 を実行してプロジェクトをビルドします