MCP 服务器

JVM MCP Server

一个基于 Arthas 的 JVM 监控和控制平台服务器，提供 Python 接口，用于监控和分析 Java 进程，具备线程分析、内存监控和性能诊断等功能。

监控

开发者工具

操作系统自动化

访问服务器

README

JVM MCP 服务器

English | 中文

一个基于 Arthas 的 JVM 监控 MCP 服务器实现，提供简单易用的 Python 接口，用于监控和分析 Java 进程。

特性

自动下载和管理 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 初始化项目环境

# 创建虚拟环境
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"  # 如果使用密码验证

快速开始

使用 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

在 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"
        ]
      }
    }
}