JVM MCP サーバー
英語|中国語
Arthas に基づく JVM 監視 MCP サーバー実装。Java プロセスを監視および分析するためのシンプルで使いやすい Python インターフェイスを提供します。
特徴
- Arthasツールの自動ダウンロードと管理
- ローカルおよびリモートのJavaプロセス監視のサポート
- Javaプロセスリストのクエリ
- リアルタイム JVM スレッド情報
- JVM メモリ使用量の監視
- スレッドスタックトレース情報
- クラスロード情報のクエリ
- クラスとメソッドのデコンパイルのサポート
- メソッド呼び出しの監視
- 動的なログレベル調整
- AI駆動型JVMパフォーマンス分析
システム要件
- Python 3.10以上
- Java ランタイム環境 (JRE) 8 以上
- ネットワーク接続(Arthasのダウンロード用)
- ターゲット サーバーへの SSH アクセス (リモート モードを使用している場合)
インストールと環境設定
1. UVツールをインストールする
## linux shell
curl -LsSf https://astral.sh/uv/install.sh | sh
## or install using pip
pip install uv
## or install using pipx (if you have pipx installed)
pipx install uv
## windows powershell
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
2. プロジェクトのクローンを作成する
git clone https://github.com/xzq-xu/jvm-mcp-server.git
cd jvm-mcp-server
3. uvを使ってプロジェクト環境を初期化する
# Create virtual environment
uv venv
# Sync project dependencies
uv sync
4. 環境変数を設定する(リモート接続の場合はオプション)
.env
ファイルを作成し、次の構成を追加します。
# Linux/Mac
ARTHAS_SSH_HOST=user@remote-host
ARTHAS_SSH_PORT=22 # Optional, default is 22
ARTHAS_SSH_PASSWORD=your-password # If using password authentication
# Windows PowerShell
$env:ARTHAS_SSH_HOST="user@remote-host"
$env:ARTHAS_SSH_PORT="22" # Optional, default is 22
$env:ARTHAS_SSH_PASSWORD="your-password" # If using password authentication
クイックスタート
- uv を使用してサーバーを起動します。
# Start in local mode
uv run jvm-mcp-server
# Start with environment file (if remote connection is configured)
uv run --env-file .env jvm-mcp-server
# Start in a specific directory (if needed)
uv --directory /path/to/project run --env-file .env jvm-mcp-server
- Python コードでの使用:
from jvm_mcp_server import JvmMcpServer
server = JvmMcpServer()
server.run()
- MCP ツールの使用:
設定ファイルの使用:
{
"mcpServers": {
"jvm-mcp-server": {
"command": "uv",
"args": [
"--directory",
"/path/to/jvm-mcp-server",
"run",
"--env-file",
"/path/to/jvm-mcp-server/.env",
"jvm-mcp-server"
]
}
}
}
構成ファイルを使用せずに、システム環境変数を読み取ります。存在しない場合は、ローカル スレッドを監視します。
{
"mcpServers": {
"jvm-mcp-server": {
"command": "uv",
"args": [
"--directory",
"/path/to/jvm-mcp-server",
"run",
"jvm-mcp-server"
]
}
}
}
利用可能なツール
利用可能なツールリスト
重要な注意事項
- 実行環境にJavaがインストールされていることを確認する
- Arthas ツールは初回実行時に自動的にダウンロードされます (arthas はホーム ディレクトリにダウンロードされます。事前にダウンロードして arthas-boot.jar という名前を付けることもできます)
- 対象のJavaプロセスへのアクセス権限が必要です
- リモートモードではSSHアクセスと適切なユーザー権限が必要です
- 開発環境での使用が推奨されますが、本番環境での使用は慎重に評価する必要があります。
フィードバック
問題が発生した場合は、問題またはプル リクエストを送信してください。
ライセンス
MITライセンス