项目介绍
Arch Linux MCP 服务器

<a href="https://glama.ai/mcp/servers/@nihalxkumar/arch-mcp">
<img width="380" height="200" src="https://gips1.baidu.com/it/u=4013997320,2520218385&fm=3081&app=3081&f=PNG?w=760&h=400" />
</a>
免责声明: 此项目为非官方社区项目,与 Arch Linux 无任何关联。
一个将AI助手与Arch Linux生态系统连接起来的模型上下文协议(MCP)服务器。它使AI能够智能、安全且高效地访问Arch Wiki、AUR以及官方仓库,从而在Arch和非Arch系统上辅助使用Arch Linux。
利用AI获取易于理解、结构化的结果,并准备好进行后续问题和操作。
📖 完整的文档及舒适指南
预览可用功能
<details open>
<summary>Claude 桌面版(无需终端)</summary>

</details>
<details>
<summary>VS Code(带终端)</summary>

</details>
资源(基于URI的访问)
通过自定义URI方案直接访问Arch生态系统数据:
文档及搜索
| URI 方案 | 示例 | 返回 |
|---|
archwiki:// | archwiki://安装指南 | Markdown 格式的Wiki页面 |
包信息
| URI 方案 | 示例 | 返回 |
|---|
archrepo:// | archrepo://vim | 官方仓库包详情 |
aur://*/info | aur://yay/info | AUR包元数据(投票数、维护者、日期) |
aur://*/pkgbuild | aur://yay/pkgbuild | 带有安全性分析的原始PKGBUILD |
系统包(仅限Arch)
| URI 方案 | 示例 | 返回 |
|---|
pacman://已安装 | pacman://已安装 | 已安装的系统包列表 |
pacman://孤儿包 | pacman://孤儿包 | 孤儿包 |
pacman://显式安装 | pacman://显式安装 | 显式安装的包 |
pacman://组 | pacman://组 | 所有包组 |
pacman://组/* | pacman://组/base-devel | 特定组中的包 |
pacman://数据库/新鲜度 | pacman://数据库/新鲜度 | 包数据库同步状态 |
系统监控及日志
| URI 方案 | 示例 | 返回 |
|---|
system://信息 | system://信息 | 系统信息(内核、内存、运行时间) |
system://磁盘 | system://磁盘 | 磁盘空间使用统计 |
system://服务/失败 | system://服务/失败 | 失败的systemd服务 |
system://日志/启动 | system://日志/启动 | 最近的启动日志 |
pacman://日志/最近 | pacman://日志/最近 | 最近的包事务 |
pacman://日志/失败 | pacman://日志/失败 | 失败的包事务 |
新闻及更新
| URI 方案 | 示例 | 返回 |
|---|
archnews://最新 | archnews://最新 | 最新的Arch Linux新闻 |
archnews://关键 | archnews://关键 | 需要手动干预的关键新闻 |
archnews://自上次更新以来 | archnews://自上次更新以来 | 自上次系统更新以来的新闻 |
配置
| URI 方案 | 示例 | 返回 |
|---|
config://pacman | config://pacman | 解析过的pacman.conf配置 |
config://makepkg | config://makepkg | 解析过的makepkg.conf配置 |
mirrors://活跃 | mirrors://活跃 | 当前配置的镜像 |
mirrors://健康状况 | mirrors://健康状况 | 镜像配置健康状况 |
工具(可执行函数)
包搜索及信息
| 工具 | 描述 | 平台 |
|---|
查询ArchWiki | 使用排名结果查询Arch Wiki | 任意 |
搜索AUR | 搜索AUR(相关性/投票数/受欢迎程度/修改日期) | 任意 |
获取官方包信息 | 获取官方包详情(混合本地/远程) | 任意 |
包生命周期管理
| 工具 | 描述 | 平台 |
|---|
检查更新干运行 | 检查可用更新 | 仅限Arch |
安全安装包 | 安装时进行安全检查(阻止恶意包) | 仅限Arch |
移除单个包 | 移除单个包(包括依赖项,强制) | 仅限Arch |
批量移除包 | 高效移除多个包 | 仅限Arch |
包分析及维护
| 工具 | 描述 | 平台 |
|---|
查找孤儿包 | 查找孤儿包 | 仅限Arch |
清理孤儿包 | 清理孤儿包(干运行,排除项) | 仅限Arch |
验证包完整性 | 检查文件完整性(修改/丢失文件) | 仅限Arch |
列出显式安装的包 | 列出用户安装的包 | 仅限Arch |
标记为显式安装 | 防止包成为孤儿包 | 仅限Arch |
标记为依赖项 | 允许包成为孤儿包 | 仅限Arch |
包组织
| 工具 | 描述 | 平台 |
|---|
查找包拥有者 | 查找哪个包拥有某个文件 | 仅限Arch |
列出包文件 | 列出包中的文件(正则表达式过滤) | 仅限Arch |
搜索包文件 | 在包之间搜索文件 | 仅限Arch |
列出包组 | 列出所有组(基础,基础开发等) | 仅限Arch |
列出特定组中的包 | 显示特定组中的包 | 仅限Arch |
系统监控及诊断
| 工具 | 描述 | 平台 |
|---|
获取系统信息 | 系统信息(内核,内存,运行时间) | 任意 |
检查磁盘空间 | 磁盘使用情况及警告 | 任意 |
获取Pacman缓存统计 | 包缓存大小及年龄 | 仅限Arch |
检查失败的服务 | 查找失败的systemd服务 | systemd |
获取启动日志 | 获取journalctl启动日志 | systemd |
检查数据库新鲜度 | 检查包数据库同步状态 | 仅限Arch |
事务历史及日志
| 工具 | 描述 | 平台 |
|---|
获取事务历史 | 最近的包事务(安装/升级/移除) | 仅限Arch |
查找安装时间 | 包安装历史 | 仅限Arch |
查找失败的事务 | 失败的包操作 | 仅限Arch |
获取数据库同步历史 | 数据库同步事件 | 仅限Arch |
新闻及安全检查
| 工具 | 描述 | 平台 |
|---|
获取最新新闻 | 从RSS获取Arch Linux新闻 | 任意 |
检查关键新闻 | 查找需要手动干预的关键新闻 | 任意 |
获取自上次更新以来的新闻 | 自上次系统更新以来发布的新闻 | 仅限Arch |
镜像管理
| 工具 | 描述 | 平台 |
|---|
列出活跃镜像 | 显示配置的镜像 | 仅限Arch |
测试镜像速度 | 测试镜像延迟 | 仅限Arch |
推荐最快的镜像 | 根据位置推荐最优镜像 | 任意 |
检查镜像列表健康状况 | 验证镜像配置 | 仅限Arch |
配置管理
| 工具 | 描述 | 平台 |
|---|
分析pacman.conf设置 | 解析pacman.conf设置 | 仅限Arch |
分析makepkg.conf设置 | 解析makepkg.conf设置 | 仅限Arch |
检查忽略的包 | 列出忽略的包(关键时警告) | 仅限Arch |
获取并行下载配置 | 获取并行下载配置 | 仅限Arch |
安全分析
| 工具 | 描述 | 平台 |
|---|
全面分析PKGBUILD的安全性 | 综合PKGBUILD分析(50多项红旗标志) | 任意 |
分析包元数据风险 | 包信任评分(投票数,维护者,年龄) | 任意 |
提示(引导工作流程)
| 提示 | 目的 | 工作流 |
|---|
故障排查 | 诊断系统错误 | 提取关键词 → 查询Wiki → 情境感知建议 |
审核AUR包 | 安装前的安全审计 | 获取元数据 → 分析PKGBUILD → 安全建议 |
分析依赖关系 | 安装规划 | 检查仓库 → 映射依赖关系 → 建议安装顺序 |
安全系统更新 | 安全更新工作流 | 检查关键新闻 → 验证磁盘空间 → 列出更新 → 检查服务 → 建议 |
安装
先决条件
快速安装使用uvx
uvx arch-ops-server
配置
Claude / Cursor / 支持STDIO传输的任何MCP客户端
{
"mcpServers": {
"arch-ops": {
"命令": "uvx",
"参数": ["arch-ops-server"]
}
}
}
贡献
非常欢迎贡献。请随时提交拉取请求或打开问题,帮助所有人改进。
贡献指南
许可证
此项目双许可,您可以选择以下之一:
您可以在任一许可证条款下使用本软件。当重新分发或修改本软件时,您可以选择适用的许可证。
通过为此项目做出贡献,您同意您的贡献将根据这两个许可证授权。