Linux Mcp

linux-mcp - Linux MCP サーバー

Model Context Protocol (MCP) を基盤とした、Linux システム監視サーバーです。MCP ツールを使用して、STDIO トランスポート経由で CPU、メモリ、ディスク、ネットワーク、プロセス、Docker などのシステム情報をリアルタイムで提供します。

機能

• システム - ホスト名、OS、カーネル、アーキテクチャ、稼働時間、ロードアベレージ
• CPU - 使用率、モデル、周波数、コア数、温度センサー
• メモリ - RAM とスワップの使用量および割合
• ディスク - パーティションごとの使用量、inode、マウントオプション、大容量ファイル、ブロックデバイス
• ネットワーク - インターフェース統計、アクティブな接続、リスニングポート、DNS、ping、IP のジオロケーションと ASN の検索
• プロセス - CPU またはメモリ順に並べた実行中のプロセス、プロセスごとのオープンファイルディスクリプター
• Docker - コンテナー、イメージ、ネットワーク、ボリューム、ディスク使用量、システム情報、コンテナー統計
• サービスと自動化 - systemd ユニット、サービスの状態、ユーザータイマー、crontab、システム cron ジョブ
• セキュリティ - アクティブなユーザーセッション、ログイン失敗の検出、SELinux/AppArmor の状態、ファイアウォール/SSH/SUID/全ユーザー書き込み可能な項目の監査とセキュリティスコア
• パッケージ - インストール済みパッケージと利用可能な更新（pacman、dpkg、rpm/dnf、apk）
• ハードウェア - GPU 情報、PCI/USB バスデバイス、電源とバッテリーの分析
• デスクトップセッション - Wayland/X11 プロトコル、DE 識別子、ランタイム設定
• ストレージの健全性 - RAID の状態、logrotate の設定、時刻同期、SMART ディスクの健全性、デバイスごとの I/O メトリクス
• システムの健全性 - メモリ、ディスク、負荷、systemd のチェックを含む総合的な健全性評価
• /proc 診断 - 割り込み、softirq、vmstat、diskstats、ファイルシステム、カーネルバージョン、slabinfo の詳細な /proc 検査
• マニュアルページ - インストール済みの任意のコマンドのシステムマニュアルページ
• スナップショット - 1 回の呼び出しでシステムの包括的な概要を取得
• MCP リソース - システムデータには、読み取り可能なリソースとしてもアクセス可能

前提条件

• Go 1.27+（ソースからビルドする場合）
• Linux（サーバーは Linux を対象としています。一部のツールは Linux 固有のパスを使用します）
• Docker（任意。Docker ツールを使う場合にのみ必要です）

インストール

MCP Registry 経由

MCP Registry でサーバーを見つけ、MCP クライアント経由でインストールしてください（VS Code のワンクリックインストール、または手動設定）。

ビルド済みバイナリをダウンロード

GitHub Releases ページから最新のバイナリをダウンロードしてください。

curl -LO https://github.com/Mohabdo21/linux-mcp/releases/latest/download/linux-mcp
chmod +x linux-mcp

libc に依存しない完全な静的ビルドも linux-mcp_static として利用できます。

go install 経由

go install github.com/Mohabdo21/linux-mcp@latest

バイナリは $GOPATH/bin/（通常は ~/go/bin/）に配置されます。

ソースからビルド

git clone https://github.com/Mohabdo21/linux-mcp.git
cd linux-mcp
make build

バイナリは bin/linux-mcp に配置されます。

libc に依存しない完全な静的バイナリの場合：

make build-static

使い方

サーバーは MCP 標準に準拠し、STDIO トランスポート経由で通信します。MCP クライアント（例：Claude Desktop、Claude Code、Codex、OpenCode、または任意の MCP ホスト）から起動されるように設計されています。

直接実行する

./bin/linux-mcp

これによりサーバーが起動し、STDIN/STDOUT で MCP リクエストを待ち受けます。

統合

{
  "mcp": {
    "linux-mcp": {
      "type": "local",
      "command": ["/path/to/linux-mcp"],
      "enabled": true
    }
  }
}

claude mcp add linux-mcp -- /path/to/linux-mcp

claude mcp add linux-mcp --scope user -- /path/to/linux-mcp

{
  "mcpServers": {
    "linux-mcp": {
      "type": "stdio",
      "command": "/path/to/linux-mcp"
    }
  }
}

codex mcp add linux-mcp -- /path/to/linux-mcp

[mcp_servers.linux-mcp]
command = "/path/to/linux-mcp"

ツールとリソース

システム、CPU、メモリ、ディスク、ネットワーク、プロセス、Docker、セキュリティ、パッケージ、ハードウェアなどをカバーする 65 個のツールと 19 個のリソースがあります。

ツールとリソースの完全なリファレンス

設定

サーバーは、~/.config/linux-mcp/config.json または LINUX_MCP_CONFIG 環境変数で指定された JSON ファイルを読み込んで設定できます。

{
  "log_level": "info",
  "timeouts": {
    "get_system_snapshot": "60s",
    "ping_host": "5s"
  },
  "disabled": []
}

サーバーは SIGHUP による実行時の設定ファイル再読み込みにも対応しており、再起動は不要です。

MCP レジストリ

MCP レジストリに io.github.Mohabdo21/linux-mcp として公開されています。

ライセンス

• MIT

依存関係

• modelcontextprotocol/go-sdk - Go 用 MCP SDK
• shirou/gopsutil/v4 - システムメトリクス（CPU、メモリ、ディスク、ネットワーク、プロセス、センサー）
• docker/go-sdk - Docker Engine API クライアント
• moby/moby/client - Docker クライアントライブラリ
• ip-api.com - 無料の IP ジオロケーション API（get_ip_info で使用）