AI导哈

Linux系统管理协议服务器

一个连接AI助手与SUSE Linux生态系统的协议服务器，提供对openSUSE Wiki、OBS和SUSE存储库的安全可靠访问，用于AI辅助系统管理。

  • by chrisjohntapp
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 chrisjohntapp/suse-mcp

使用说明

SUSE Linux MCP服务器

A. 模型上下文协议 （MCP）服务器，将AI助手与SUSE Linux生态系统连接起来。允许安全、可靠地访问openSUSE Wiki、OBS（开放构建服务）和SUSE存储库，以进行人工智能辅助系统管理。

支持所有SUSE变体：openSUSE Tumbleweed、Leap、MicroOS、Slowloll、SLES、SLED和SLE Micro。不可变变体使用 transactional-update 自动。

资源（基于URI的访问）

文档和搜索

URI方案 示例 返回
opensuse-wiki:// opensuse-wiki://Installation_guide Markdown格式的Wiki页面

包裹信息

URI方案 示例 返回
suse-repo:// suse-repo://vim 官方存储库包详细信息
obs://*/spec obs://vim/spec 带安全分析的OBS规范文件
obs://*/info obs://vim/info OBS包元数据

系统包（仅限SUSE）

URI方案 示例 返回
zypper://installed zypper://installed 已安装软件包列表
zypper://orphans zypper://orphans 孤立包裹
zypper://explicit zypper://explicit 明确安装的软件包
zypper://patterns zypper://patterns Zypper图案
zypper://database/freshness zypper://database/freshness 包数据库同步状态

系统监控和日志

URI方案 示例 返回
system://info system://info 系统信息（内核、内存、正常运行时间）
system://disk system://disk 磁盘空间使用统计
system://services/failed system://services/failed 失败的systemd服务
system://logs/boot system://logs/boot 最近的启动日志
system://health system://health 系统健康检查
zypper://log/recent zypper://log/recent 最近的包裹交易
zypper://log/failed zypper://log/failed 包裹交易失败

新闻和更新

URI方案 示例 返回
opensuse-news://latest opensuse-news://latest openSUSE最新消息
opensuse-news://critical opensuse-news://critical 需要人工干预的关键新闻
opensuse-news://since-update opensuse-news://since-update 自上次系统更新以来的新闻

配置

URI方案 示例 返回
config://zypper config://zypper 已解析zypper.conf配置
config://rpm-macros config://rpm-macros 解析的RPM宏配置
mirrors://active mirrors://active 当前配置的存储库
mirrors://health mirrors://health 存储库运行状况

工具

工具 说明
search_opensuse_wiki 使用排名结果查询openSUSE Wiki
search_obs 搜索OBS套餐
get_official_package_info 获取官方套餐详情
check_updates_dry_run 检查可用更新
install_obs_package 安装带有安全检查的OBS包
audit_obs_security OBS包的安全审计（规范分析、全面审计）
remove_packages 移除包装（单个或批量）
manage_orphans 列出或删除孤立包
query_file_ownership 文件包所有权查询
verify_package_integrity 检查文件完整性
manage_patterns 列出并检查zypper图案
manage_install_reason 管理安装原因（显式/依赖性）
get_system_info 系统信息（内核、内存、正常运行时间）
analyze_storage 磁盘使用和缓存统计信息
diagnose_system 系统诊断
fetch_news 获取openSUSE新闻
query_package_history 查询zypp交易历史
optimize_mirrors 存储库管理（状态、测试、建议、运行状况）
analyze_zypper_conf 解析zypper.conf设置
analyze_rpm_macros 解析RPM宏配置
check_database_freshness 检查包数据库同步状态
run_system_health_check 全面的系统健康检查

提示

提示 目的
troubleshoot_issue 使用openSUSE Wiki诊断系统错误
audit_obs_package OBS包的安装前安全审计
analyze_dependencies 依赖性分析和安装顺序
safe_system_update 飞行前检查的安全更新工作流程
cleanup_system 系统清理（孤立、缓存、完整性）
package_investigation 安装前进行深入的软件包研究
mirror_optimization 测试和配置最快的镜像
system_health_check 全面的系统诊断

安装

先决条件

快速开始

uv run suse-ops-server

配置

添加到MCP客户端配置（Claude、Cursor或任何兼容STDIO的客户端）：

{
  "mcpServers": {
    "suse-linux": {
      "command": "uv",
      "args": ["run", "suse-ops-server"]
    }
  }
}

容器

podman build -f Containerfile .
podman run -i suse-mcp-server

许可证

此项目根据您的选择获得双重许可：

相关 MCP