arthas-mcp

Idiomas: Inglés | 简体中文

Un servidor MCP que conecta Alibaba Arthas con Claude Code, Cursor, Codex y cualquier otro asistente de IA compatible con MCP. Escanea los JVM locales cada 15 segundos, filtra los demonios de IDE/compilación, adjunta Arthas automáticamente y expone herramientas de diagnóstico listas para usar — así que puedes simplemente preguntarle a tu agente "¿por qué el servicio de pedidos va lento?" y puede ejecutar thread, trace, watch y ognl en el proceso en vivo.

AI agent ──stdio/HTTP──> arthas-mcp ──auto-attach──> Arthas agent ──> your JVM
                             ▲
                    jps discovery every 15s

Cómo se compara

Related MCP server: Arthas MCP Server

Características

• Descubrimiento de cero configuración — encuentra JVM de negocio mediante jps, omite los demonios de IntelliJ / Gradle / Maven / language-server mediante una lista negra integrada

• Adjuntar y re-adjuntar automático — inicia arthas-boot por proceso en un pool de puertos gestionado, y se re-adjunta cuando un agente se cae

• Ejecución de comandos síncrona y asíncrona — los comandos cortos (version, sc, sm, ognl) devuelven directamente; los de larga duración (trace, watch, monitor) se transmiten mediante pull_results y pueden interrumpirse

• Modos stdio y HTTP — una instancia por sesión de cliente (stdio), o un servicio compartido de larga duración (--http) con /mcp + /healthz

• Salida amigable — los resultados de los trabajos de Arthas se condensan en texto limpio que un LLM puede leer directamente

• Multiplataforma — macOS, Linux y Windows (introspección de procesos por SO: /proc, ps, PowerShell CIM)

Plataformas compatibles

Requisitos: Node ≥ 18, un JDK (para jps y java), y Arthas — auto-detectado desde ~/.arthas/lib (es decir, ya está instalado si has ejecutado arthas-boot antes), o apunta ARTHAS_BOOT_JAR a arthas-boot.jar. Todas las dependencias son gratuitas y de código abierto.

Instalación

Ejecutar sin instalar (recomendado)

npx -y github:x0c/arthas-mcp --version

Instalar globalmente

npm install -g github:x0c/arthas-mcp
arthas-mcp --version

Los mismos comandos en macOS, Linux y Windows. Una vez publicado en el registro npm, ambos se reducen a npx -y arthas-mcp / npm install -g arthas-mcp.

Desde el código fuente

git clone https://github.com/x0c/arthas-mcp.git
cd arthas-mcp && npm install
node cli/arthas-mcp.mjs --version

Configura tu cliente MCP

Claude Code:

claude mcp add arthas -- npx -y github:x0c/arthas-mcp

Cursor / cualquier cliente que lea un bloque JSON mcpServers:

{
  "mcpServers": {
    "arthas": {
      "command": "npx",
      "args": ["-y", "github:x0c/arthas-mcp"]
    }
  }
}

Modo demonio compartido (una instancia para todos los clientes):

{
  "mcpServers": {
    "arthas": {
      "command": "npx",
      "args": ["-y", "github:x0c/arthas-mcp", "--http"],
      "url": "http://127.0.0.1:8580/mcp"
    }
  }
}

Uso

Inicia tu servicio Java, espera unos segundos y luego pregúntale al agente — o llama tú mismo a las herramientas:

Ejemplo de sesión:

You:  why is the order service slow?
Agent: (list_agents) → order-service is online on port 18501
       (exec order-service "thread -n 3")     → hottest threads
       (async_exec order-service "trace *OrderService create") → submits trace
       (pull_results …)                       → shows the slow call chain

Configuración

Precedencia: argumentos de CLI > variables de entorno > ~/.config/arthas-mcp/config.json > valores por defecto.

Preguntas frecuentes

¿Por qué no el arthas-mcp-server oficial? Resuelven problemas diferentes: el oficial es un módulo Java en proceso para diagnósticos alojados en producción, este proyecto es un envoltorio local que descubre y se adjunta a cualquier JVM sin tocar la aplicación. Pueden coexistir.

¿Modifica mi aplicación? Adjunta el agente de Arthas al JVM en ejecución (como ejecutar arthas-boot manualmente) — sin reiniciar, sin cambiar código. Detén la herramienta o ejecuta stop para desadjuntar.

¿Es seguro apuntar un LLM a producción? Le da al agente el mismo poder que tiene Arthas (incluyendo watch a nivel de bytecode). Apúntalo a JVM locales/de desarrollo, y usa criterio de solo lectura en producción.

Licencia

MIT