arthas-mcp

言語: English | 简体中文

Alibaba Arthas を Claude Code、Cursor、Codex、その他の MCP 対応 AI アシスタントに橋渡しする MCP サーバーです。ローカル JVM を 15秒ごとにスキャンし、IDE/ビルドデーモンを除外して、Arthas を自動的にアタッチし、すぐ使える診断ツールを公開します。エージェントに 「注文サービスが遅いのはなぜ？」 と質問するだけで、実行中のプロセスに対して thread、trace、watch、ognl を実行できます。

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

他のツールとの比較

Related MCP server: Arthas MCP Server

特徴

• ゼロ設定の検出 — jps でビジネス JVM を検出し、組み込みブラックリストで IntelliJ / Gradle / Maven / language-server のデーモンを除外します

• 自動アタッチ＆再アタッチ — 管理されたポートプールでプロセスごとに arthas-boot を起動し、エージェントが切断されたら再アタッチします

• 同期＋非同期のコマンド実行 — 短時間のコマンド（version、sc、sm、ognl）は直接返し、長時間実行のもの（trace、watch、monitor）は pull_results でストリーミングし、中断できます

• stdio と HTTP モード — クライアントセッションごとに1インスタンス（stdio）、または共有の常駐サービス（--http）で /mcp + /healthz を提供

• わかりやすい出力 — Arthas のジョブ結果を、LLM が直接読めるクリーンなテキストにまとめます

• クロスプラットフォーム — macOS、Linux、Windows（OSごとのプロセス検査: /proc、ps、PowerShell CIM）

対応プラットフォーム

必要条件: Node ≥ 18、JDK（jps と java 用）、および Arthas — ~/.arthas/lib から自動検出されます（つまり、以前に arthas-boot を実行したことがあればすでにインストールされています）。または ARTHAS_BOOT_JAR で arthas-boot.jar を指定します。依存関係はすべて無料のオープンソースです。

インストール

インストールせずに実行（推奨）

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

グローバルインストール

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

macOS、Linux、Windows で同じコマンドです。npm レジストリに公開されると、どちらも npx -y arthas-mcp / npm install -g arthas-mcp に短縮されます。

ソースから

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

MCP クライアントを設定する

Claude Code:

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

Cursor / mcpServers JSON ブロックを読み取る任意のクライアント:

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

共有デーモンモード（全クライアントで1つのインスタンス）:

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

使い方

Java サービスを起動し、数秒待ってからエージェントに質問するか、自分でツールを呼び出します:

セッション例:

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

設定

優先順位: CLI 引数 > 環境変数 > ~/.config/arthas-mcp/config.json > デフォルト。

FAQ

公式の arthas-mcp-server ではなく、なぜこれを使うのか？ これらは異なる問題を解決します。公式版は本番ホストでの診断用のインプロセス Java モジュールであり、このプロジェクトはアプリに触れずに 任意の JVM を検出してアタッチするローカルサイドのラッパーです。両者は共存できます。

アプリケーションを変更しますか？ 実行中の JVM に Arthas エージェントをアタッチするだけです（手動で arthas-boot を実行するのと同じ）。再起動もコード変更もありません。ツールを停止するか stop を実行するとデタッチします。

本番環境に LLM を向けても安全ですか？ エージェントに Arthas と同じ能力（バイトコードレベルの watch を含む）を与えます。ローカル/開発 JVM に向けて、本番では読み取り専用の判断を使用してください。

ライセンス

MIT