Arch Mcp

Arch Linux MCP サーバー

免責事項: 非公式のコミュニティプロジェクトであり、Arch Linux とは提携していません。

AI アシスタントと Arch Linux エコシステムをつなぐ Model Context Protocol（MCP）サーバーです。Arch Wiki、AUR、公式リポジトリへの知的で安全かつ効率的なアクセスを可能にし、Arch システムおよび非 Arch システムでの AI 支援による Arch Linux の利用を実現します。

AI を活用して、追加の質問や操作にそのまま対応できる、わかりやすく構造化された結果を取得できます。

📖 Comfy ガイド付きの完全なドキュメント

利用可能な機能の一部をのぞいてみる

VS Code Sonnet 3.5 を使って AUR から安全にインストールする

Claude Code Sonnet 4.5 に fedora の同等コマンドを尋ねる

リソース（URI ベースのアクセス）

カスタム URI スキームを通じて Arch エコシステムのデータに直接アクセスできます：

ドキュメントと検索

URI スキーム	例	返される内容
archwiki://	archwiki://Installation_guide	Markdown 形式の Wiki ページ

パッケージ情報

URI スキーム	例	返される内容
archrepo://	archrepo://vim	公式リポジトリのパッケージ詳細
aur://*/info	aur://yay/info	AUR パッケージのメタデータ（投票数、メンテナー、日付）
aur://*/pkgbuild	aur://yay/pkgbuild	安全性分析付きの生の PKGBUILD

システムパッケージ（Arch のみ）

URI スキーム	例	返される内容
pacman://installed	pacman://installed	システムにインストール済みのパッケージ一覧
pacman://orphans	pacman://orphans	孤立したパッケージ
pacman://explicit	pacman://explicit	明示的にインストールされたパッケージ
pacman://groups	pacman://groups	すべてのパッケージグループ
pacman://group/*	pacman://group/base-devel	特定のグループ内のパッケージ
pacman://database/freshness	pacman://database/freshness	パッケージデータベースの同期状態

システム監視とログ

URI スキーム	例	返される内容
system://info	system://info	システム情報（カーネル、メモリ、稼働時間）
system://disk	system://disk	ディスク容量の使用状況
system://services/failed	system://services/failed	失敗した systemd サービス
system://logs/boot	system://logs/boot	最近の起動ログ
pacman://log/recent	pacman://log/recent	最近のパッケージトランザクション
pacman://log/failed	pacman://log/failed	失敗したパッケージトランザクション

ニュースとアップデート

URI スキーム	例	返す内容
archnews://latest	archnews://latest	最新の Arch Linux ニュース
archnews://critical	archnews://critical	手動での対応が必要な重要なニュース
archnews://since-update	archnews://since-update	最後のシステム更新以降のニュース

設定

URI スキーム	例	返す内容
config://pacman	config://pacman	解析済みの pacman.conf 設定
config://makepkg	config://makepkg	解析済みの makepkg.conf 設定
mirrors://active	mirrors://active	現在設定されているミラー
mirrors://health	mirrors://health	ミラー設定のヘルスステータス

ツール（実行可能な関数）

パッケージの検索と情報

ツール	説明	プラットフォーム
search_archwiki	ランク付けされた結果で Arch Wiki を検索	すべて
search_aur	AUR を検索（関連度/投票数/人気度/更新日時）	すべて
get_official_package_info	公式パッケージの詳細を取得（ローカル/リモートのハイブリッド）	すべて

パッケージのライフサイクル管理

ツール	説明	プラットフォーム
check_updates_dry_run	利用可能なアップデートを確認	Arch のみ
install_package_secure	セキュリティチェック付きでインストール（悪意のあるパッケージをブロック）	Arch のみ
remove_packages	パッケージを削除 - 単一のパッケージ名またはリストを受け付けます（依存関係付き、強制）	Arch のみ

パッケージの分析とメンテナンス

ツール	説明	プラットフォーム
manage_orphans	孤立したパッケージを管理（2 つのアクション: 孤立パッケージの一覧表示、孤立パッケージの削除）。安全性のため常に最初にドライランモードで実行されます。	Arch のみ
verify_package_integrity	ファイルの整合性を確認（変更/欠落したファイル）	Arch のみ
manage_install_reason	インストール理由を管理（3 つのアクション: 明示的パッケージの一覧表示、明示的/依存関係としてマーク）	Arch のみ

パッケージの整理

ツール	説明	プラットフォーム
query_file_ownership	統合されたファイル-パッケージ所有権のクエリ（3 つのモード: ファイル→パッケージ、パッケージ→ファイル、ファイル名検索）	Arch のみ
list_package_groups	すべてのグループを一覧表示（base、base-devel など）	Arch のみ
list_group_packages	特定のグループ内のパッケージを表示	Arch のみ

システム監視と診断

ツール	説明	プラットフォーム
get_system_info	システム情報（カーネル、メモリ、稼働時間）	すべて
check_disk_space	警告付きのディスク使用量	すべて
get_pacman_cache_stats	パッケージキャッシュのサイズと経過時間	Arch のみ
check_failed_services	失敗した systemd サービスの検出	systemd
get_boot_logs	journalctl の起動ログの取得	systemd
check_database_freshness	パッケージデータベースの同期状態の確認	Arch のみ

トランザクション履歴とログ

ツール	説明	プラットフォーム
query_package_history	pacman ログからパッケージ履歴を照会するための統合ツール（4 種類のクエリタイプ）。例: query_type='all' は最近のトランザクションを表示します。query_type='package', package_name='docker' は docker がいつインストール/アップグレードされたかを表示します。query_type='failures' は失敗した操作を表示します。query_type='sync' はデータベース同期履歴を表示します。	Arch のみ

ニュースと安全性チェック

ツール	説明	プラットフォーム
get_latest_news	RSS から Arch Linux のニュースを取得	すべて
check_critical_news	重大なニュース（手動介入が必要）の検出	すべて
get_news_since_last_update	最後のシステム更新以降に投稿されたニュース	Arch のみ

ミラー管理

ツール	説明	プラットフォーム
optimize_mirrors	スマートなミラー管理（4 つのアクション: status、test、suggest、health）。例: optimize_mirrors(action='status', auto_test=True) はすべてのミラーを一覧表示してテストします。optimize_mirrors(action='suggest', country='US', limit=5) は米国のトップ 5 ミラーを提案します。optimize_mirrors(action='health') は問題をチェックして推奨事項を提示します。	Arch/すべて

構成管理

ツール	説明	プラットフォーム
analyze_pacman_conf	任意のフォーカスを指定して pacman.conf の設定を解析します。例: focus='full' (デフォルト) はすべての設定を返します。focus='ignored_packages' は無視されたパッケージのみを返し、重要なものについては警告を表示します。focus='parallel_downloads' は並列ダウンロード設定のみを返し、最適化の推奨事項を表示します。	Arch のみ
analyze_makepkg_conf	makepkg.conf の設定 (CFLAGS、MAKEFLAGS、ビルド構成) を解析します	Arch のみ

セキュリティ分析

ツール	説明	プラットフォーム
analyze_pkgbuild_safety	包括的な PKGBUILD 分析 (50 以上のレッドフラグ)	すべて
analyze_package_metadata_risk	パッケージの信頼スコアリング (投票数、メンテナー、経過時間)	すべて

プロンプト (ガイド付きワークフロー)

プロンプト	目的	ワークフロー
troubleshoot_issue	システムエラーの診断	キーワードの抽出 → Wiki の検索 → コンテキストを考慮した提案
audit_aur_package	インストール前の安全性監査	メタデータの取得 → PKGBUILD の分析 → セキュリティに関する推奨事項
analyze_dependencies	インストール計画	リポジトリの確認 → 依存関係のマッピング → インストール順序の提案
safe_system_update	安全な更新ワークフロー	重要なニュースの確認 → ディスク容量の確認 → 更新の一覧表示 → サービスの確認 → 推奨事項

---

インストール

前提条件

• Python 3.11+
• uv (推奨) または pip

uvx によるクイックインストール

uvx arch-ops-server

---

構成

Claude / Cursor / STDIO トランスポートをサポートする任意の MCP クライアント

{
  "mcpServers": {
    "arch-linux": {
      "command": "uvx",
      "args": ["arch-ops-server"]
    }
  }
}

Opencode:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "arch-linux": {
      "type": "local",
      "command": ["uvx", "arch-ops-server"]
    }
  }
}

コントリビューション

コントリビューションを心より歓迎します。プルリクエストの送信や issue の作成をぜひお気軽に行っていただき、すべての人のためにプロジェクトをより良くするためにご協力ください。

コントリビューションガイド

ライセンス

このプロジェクトは、以下のいずれかを選択できるデュアルライセンスです:

• GPL-3.0-only - 強力なコピーレフト保護を好む方向け。詳しくは LICENSE-GPL をご覧ください
• MIT License - プロプライエタリソフトウェアでの使用や Docker MCP Catalog のようなプラットフォームとの互換性を含む、より広範な互換性と採用を目的としています。詳しくは LICENSE-MIT をご覧ください

このソフトウェアは、いずれかのライセンスの条件の下で使用できます。このソフトウェアを再配布または改変する際は、適用するライセンスを選択できます。

このプロジェクトにコントリビュートすることにより、あなたのコントリビューションが両方のライセンスの下でライセンスされることに同意したものとみなされます。