Arch Mcp

Arch Linux MCP 服务

免责声明： 非官方社区项目，与 Arch Linux 无关联。

一个 Model Context Protocol (MCP) 服务，将 AI 助手与 Arch Linux 生态连接起来。让 AI 在 Arch 和非 Arch 系统上辅助使用 Arch Linux 时，能够智能、安全且高效地访问 Arch Wiki、AUR 和官方仓库。

借助 AI 获得易于理解、结构化的结果，随时可进行后续提问和操作。

📖 完整文档与贴心指南

功能抢先看

使用 VS Code Sonnet 3.5 从 AUR 安全安装

向 Claude Code Sonnet 4.5 询问 Fedora 中的等效命令

资源（基于 URI 的访问）

通过自定义 URI 方案直接访问 Arch 生态数据：

文档与搜索

URI Scheme	Example	Returns
archwiki://	archwiki://Installation_guide	Markdown 格式的 Wiki 页面

软件包信息

URI Scheme	Example	Returns
archrepo://	archrepo://vim	官方仓库软件包详情
aur://*/info	aur://yay/info	AUR 软件包元数据（投票数、维护者、日期）
aur://*/pkgbuild	aur://yay/pkgbuild	带安全分析的原始 PKGBUILD

系统软件包（仅 Arch）

URI Scheme	Example	Returns
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 Scheme	Example	Returns
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 Scheme	Example	Returns
archnews://latest	archnews://latest	最新的 Arch Linux 新闻
archnews://critical	archnews://critical	需要人工干预的重要新闻
archnews://since-update	archnews://since-update	自上次系统更新以来的新闻

配置

URI Scheme	Example	Returns
config://pacman	config://pacman	解析后的 pacman.conf 配置
config://makepkg	config://makepkg	解析后的 makepkg.conf 配置
mirrors://active	mirrors://active	当前配置的镜像源
mirrors://health	mirrors://health	镜像源配置健康状态

工具（可执行函数）

软件包搜索与信息

Tool	Description	Platform
search_archwiki	查询 Arch Wiki，返回排序后的结果	Any
search_aur	搜索 AUR（相关度/投票数/受欢迎程度/修改时间）	Any
get_official_package_info	获取官方软件包详细信息（本地/远程混合）	Any

软件包生命周期管理

Tool	Description	Platform
check_updates_dry_run	检查可用更新	Arch only
install_package_secure	安装时进行安全检查（阻止恶意软件包）	Arch only
remove_packages	移除软件包 - 接受单个软件包名称或列表（含依赖，强制）	Arch only

软件包分析与维护

Tool	Description	Platform
manage_orphans	管理孤立软件包（2 个操作：列出孤立软件包、移除孤立软件包）。为安全起见，始终先以 dry-run 模式运行。	Arch only
verify_package_integrity	检查文件完整性（已修改/缺失的文件）	Arch only
manage_install_reason	管理安装原因（3 个操作：列出显式安装的软件包、标记为显式/依赖）	Arch only

软件包组织

Tool	Description	Platform
query_file_ownership	统一的文件-软件包归属查询（3 种模式：文件→软件包、软件包→文件、文件名搜索）	Arch only
list_package_groups	列出所有软件包组（base、base-devel 等）	Arch only
list_group_packages	显示特定组中的软件包	Arch only

系统监控与诊断

工具	描述	平台
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"]
    }
  }
}

贡献

非常欢迎贡献。请随时提交拉取请求或提出问题，帮助为大家改进项目。

贡献指南

许可证

本项目采用双重许可，您可选择：

• GPL-3.0-only - 适合偏好强 copyleft 保护的用户。见 LICENSE-GPL
• MIT License - 适合更广泛的兼容性和采用，包括在专有软件中使用，以及与 Docker MCP Catalog 等平台的兼容性。见 LICENSE-MIT

您可以在任一许可证的条款下使用本软件。在重新分发或修改本软件时，您可以选择适用的许可证。

通过向本项目贡献，您同意您的贡献将依据这两个许可证进行许可。