Claude systemd

Linux上のClaude Desktop向け読み取り専用systemdインスペクションツールです。Claudeが「なぜこのサービスは壊れているのか？」というLinux運用の最も一般的な疑問に、ユーザーが手動で systemctl や journalctl の出力をコピー＆ペーストすることなく回答できるようになります。

7つのツールで、ユニット一覧の取得、ユニットごとのステータス確認、ジャーナルの追跡、失敗したユニットの検索、ユニットプロパティの検査、生のユニットファイル表示（ドロップインオーバーライドを含む）、およびキューに入れられたジョブの検査をカバーします。

v0.1では厳格な読み取り専用です。 restart、enable、disable、daemon-reload は実行できません。本番環境のホストや共有システムでも安全に有効化できます。破壊的な制御が必要な場合は、claude-terminal-mcp を介してそれらのコマンドを手動で実行してください。

要件

• systemdを搭載したLinux（最新のUbuntu/Debian/Fedora/Archなど）。

• PATH 上に systemctl と journalctl があること（systemdの標準）。

• 調査対象のユニットに対するジャーナルの読み取り権限。デフォルトでは、システム全体のジャーナルにアクセスするには systemd-journal または adm グループに所属している必要があります。ユーザースコープのジャーナルは、常にその所有者が読み取り可能です。

Related MCP server: systemd-mcp

インストール (Claude Desktop)

1. Releases ページから最新の Systemd.mcpb をダウンロードします。

2. 設定 → 拡張機能 → 拡張機能開発者 → 拡張機能をインストール → .mcpb ファイルを選択します。

3. 有効化します。

ツール

すべてのツールは --user ユニットを調査するための scope: "user" をサポートしています。デフォルトのスコープは system です。

プロンプト例

「現在失敗している状態のものはありますか？」 → failed_units

「なぜ ollama.service はGPUを使っていないのですか？ドロップインオーバーライドと最後の50行のログを見せてください。」 → unit_cat ollama を実行後、tail_journal unit=ollama lines=50

「過去10分間のエラー以上のジャーナルは何と言っていますか？」 → tail_journal priority=3 since="10 minutes ago"

「nginx は起動時に有効になっていますか？また、前回の起動から何回再起動しましたか？」 → unit_status nginx

プライバシーポリシー

この拡張機能は完全にローカルマシン上で実行され、systemctl と journalctl を呼び出すだけです。データがマシンから外部へ送信されることはありません。ネットワークI/Oもありません。読み取り専用であり、変更、再起動、有効化、無効化、リロードは一切できません。

Claudeが閲覧可能な情報は以下の通りです：

• クエリしたすべてのシステムまたはユーザーユニットの名前、説明、メタデータ（list_units を呼び出した場合はロードされているすべてのユニット）。

• ユニットファイルとドロップインオーバーライドの全内容 (unit_cat) — これらには、設定されている場合、機密情報を含む Environment= 行が含まれる可能性があります。この拡張機能を有効にする予定がある場合は、ユニットファイルに認証情報を保存しないでください。

• クエリされたユニットの最近のジャーナルエントリ — サービスがログに記録するメッセージには、個人を特定できる情報、IPアドレス、リクエストパス、スタックトレースが含まれる可能性があります。

• サービスのプロセスID、再起動回数、実行時プロパティ。

ユニットファイルやジャーナルに機密データが含まれており、LLMエンドポイントを信頼できない場合は、この拡張機能を有効にしないでください。

なぜ破壊的な操作ができないのか？

restart_unit / enable_unit / disable_unit セットは、以下の理由により意図的にv0.1から除外されました：

1. システムスコープのユニットにはroot権限が必要であり、これはClaude Desktopをrootで実行する（危険）か、sudo ルールを設定する（拡張機能固有の摩擦）必要があるため。

2. この拡張機能が実際に提供するワークフロー（「なぜXは壊れているのか」という95%のケース）では、それらはほとんど必要ないため。

3. サービスを再起動する必要がある場合は、既存の claude-terminal-mcp を使用すれば、どこでも使用するのと同じ sudo メカニズムで run_command sudo systemctl restart <unit> を実行でき、さらにシステムプロンプトでの確認ステップも含まれるため。

この拡張機能を読み取り専用に保つことで、信頼性の懸念なしに本番ホスト、共有ワークステーション、または顧客のマシンで有効にできます。v0.2で再検討する可能性があります。

トラブルシューティング

「systemctl is not installed」 — このサーバーはLinux専用です。macOSやWindowsではsystemdは実行されません。

「Permission denied」がジャーナル読み取り時に発生する — systemd-journal または adm グループに自分を追加してください：sudo usermod -aG systemd-journal $USER を実行し、ログアウトして再ログインします。または、scope: "user" を指定して呼び出し、自分自身のユーザースコープのジャーナルのみを読み取ってください（グループは不要です）。

tail_journal の結果が空 — 一部のディストリビューションでは、ジャーナルがレート制限されているか、揮発性です。/etc/systemd/journald.conf の Storage= を確認してください。volatile は、再起動時にジャーナルが消去されることを意味します。

開発

約400行の単一Node.jsスクリプトで、npm依存関係はゼロです。.mcpb を再ビルドするには：

cd bundle-source
zip -j ../Systemd.mcpb manifest.json package.json server.js README.md LICENSE icon.png glama.json

ライセンス

MIT。 LICENSE を参照してください。

関連

• claude-terminal-mcp — シェル + ファイルシステム + バックグラウンドジョブ（破壊的なsystemctlアクションにはこれを使用してください）。

• claude-sessions-mcp — 長時間実行ジョブのためのtmuxセッション管理。

• claude-rocm-mcp — AMD GPU監視。「GPUは健全か？」という質問と「GPUサービスは健全か？」という質問を組み合わせるのに適しています。

• claude-linux-mcp — X11デスクトップ制御。

• claude-ollama-mcp — ローカルOllama HTTP-APIクライアント。