Jvm MCP Server

🚀 JVM MCP 服務器

基於 Arthas 實現的一個 JVM 監控 MCP 服務器，提供簡單易用的 Python 接口，可用於監控和分析 Java 進程，幫助開發者更好地瞭解 Java 程序運行狀態。

🚀 快速開始

啟動服務器

1. 使用 uv 運行服務器：

# 在本地模式下啟動
uv run jvm-mcp-server

# 帶環境變量文件運行（若配置了遠程連接）
uv run --env-file .env jvm-mcp-server

# 在特定目錄下運行（如有需要）
uv --directory /path/to/project run --env-file .env jvm-mcp-server

2. 在 Python 代碼中使用：

from jvm_mcp_server import JvmMcpServer

server = JvmMcpServer()
server.run()

3. 使用 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"
        ]
      }
    }
}

✨ 主要特性

• 自動下載和管理 Arthas 工具
• 支持本地和遠程 Java 進程監控
• Java 進程列表查詢
• 即時 JVM 線程信息
• JVM 內存使用情況監控
• 線程堆棧跟蹤信息
• 類加載信息查詢
• 支持類和方法反編譯
• 方法調用監控
• 動態日誌級別調整
• 人工智能驅動的 JVM 性能分析

📦 安裝指南

系統要求

• Python 3.10+
• Java 運行時環境 (JRE) 8+
• 網絡連接（用於下載 Arthas）
• 目標服務器的 SSH 訪問權限（若使用遠程模式）

安裝步驟

1. 安裝 uv 工具

## Linux Shell
curl -LsSf https://astral.sh/uv/install.sh | sh
## 或者使用 pip 安裝
pip install uv
## 或者使用 pipx（若已安裝 pipx）
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 初始化項目環境

# 創建虛擬環境
uv venv
# 同步項目依賴項
uv sync

4. 配置環境變量（可選，用於遠程連接）

創建一個 .env 文件，並添加以下配置：

# Linux/Mac
ARTHAS_SSH_HOST=user@remote-host
ARTHAS_SSH_PORT=22  # 可選，默認為 22
ARTHAS_SSH_PASSWORD=your-password  # 若使用密碼認證

# Windows PowerShell
$env:ARTHAS_SSH_HOST="user@remote-host"
$env:ARTHAS_SSH_PORT="22"  # 可選，默認為 22
$env:ARTHAS_SSH_PASSWORD="your-password"  # 若使用密碼認證

📚 詳細文檔

注意事項

• 人工智能驅動的 JVM 性能分析