jvm-mcp-server

🚀 JVM MCP 服务器

这是一个基于 Arthas 实现的 JVM 监控 MCP 服务器，它提供了简单易用的 Python 接口，可用于监控和分析 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 性能分析

📦 安装指南

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"  # 若使用密码认证

📚 详细文档

系统要求

• Python 3.10+
• Java 运行时环境 (JRE) 8+
• 网络连接（用于下载 Arthas）
• 目标服务器的 SSH 访问权限（若使用远程模式）

⚠️ 注意事项

人工智能驱动的 JVM 性能分析相关内容在使用时需关注其准确性和适用性，结合实际情况进行参考和判断。