MCP Jetbrains

🚀 JetBrains MCP 代理サーバー

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

🚀 クイックスタート

このセクションでは、JetBrains MCP 代理サーバーの基本的な使い方を説明します。

✨ 主な機能

• クライアントのリクエストを JetBrains IDE に代理する。
• Claude Desktop との統合が可能。
• 複数の IDE への接続設定が可能。
• ログ記録を有効化できる。

📦 インストール

MCP サーバープラグインのインストール

以下のリンクから 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"]
    }
  }
}

設定

特定の IDE への接続設定

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

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

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

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

ログ記録の有効化

ログ記録を有効にするには、以下を追加してください。

"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 で Node Version Manager (nvm) を使用して 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 に接続できないエラーが発生することがあります。

解決策：

1. 外部接続を有効にする： JetBrains IDE で「Can accept external connections」（外部接続を受け入れる）を有効にしてください。設定パス：設定 | 構築、実行、デプロイ | デバッガー。

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 をコンピューターの LAN IP アドレス（例：192.168.0.12）に置き換えてください。

ビルド方法

1. macOS でテスト済みです。
2. brew install node pnpm を使用して依存関係をインストールします。
3. 上記の手順に従ってその他の設定を行います。