Jetbrains IDE

🚀 JetBrains MCP 代理サーバー

このサーバーは、クライアントのリクエストを JetBrains IDE に代理します。

🚀 クイックスタート

📦 インストール

MCP サーバープラグインをインストールするには、以下のリンクを使用してください。 https://plugins.jetbrains.com/plugin/26071-mcp-server

💻 使用例

基本的な使用法

Claude デスクトップ版と一緒に使用するには、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"]
    }
  }
}

高度な使用法

特定の IDE への接続

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

"env": {
  "IDE_PORT": "<IDE の組み込み Web サーバーのポート>"
}

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

"env": {
  "HOST": "<IDE の組み込み Web サーバーのホスト/アドレス>"
}

ログ記録を有効にするには、以下を追加します。

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

🔧 技術詳細

Node.js バージョンの要件

問題： エラーメッセージ：モジュール 'node:path' が見つかりません

解決策： MCP Proxy は Node.js 16 では動作しません。Node.js を 18 以上のバージョンにアップグレードしてください。設定内の command が正しい Node.js バージョンを指していることを確認してください。最新バージョンの NodeJS の完全なパスを使用してみてください。

MacOS：nvm でインストールした Node.js の検出に失敗する

問題： MacOS で、nvm（Node バージョンマネージャー）を使用して Node.js をインストールした場合、MCP サーバープラグインが Node.js のインストールを検出できないことがあります。

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

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

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

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

問題： 外部クライアント、Docker コンテナ、またはその他のサードパーティアプリケーション（例：LibreChat）から JetBrains MCP プロキシに接続しようとすると、リクエストが成功しないことがあります。例えば、http://host.docker.internal:6365/api/mcp/list_tools が 404 エラーを返すことがあります。

解決策：

1. 外部接続を有効にする： JetBrains IDE で、「設定 | ビルド、実行、デバッグ | デバッガー」の「外部接続を受け入れる」を有効にします。
2. LAN IP とポートの設定を使用する： host.docker.internal ではなく、マシンの LAN IP アドレスを使用します。 IDE のポートとホストアドレスを明示的に設定します。 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 を実行してプロジェクトをビルドします。