Apache HTTP Server AIops

io.github.AIops-tools由 GitHub 账号 AIops-tools 发布v0.2.0更新于 Nov 5, 2026

Governed Apache HTTP Server operations — 17 MCP tools with audit.

已验证STDIO仅桌面云端与基础设施安全与监控

概览

AI 生成的概览

本地 MCP 服务器，让助手通过 apachectl、健康探测和日志检查并诊断 Apache HTTP Server，每次调用都有审计记录。

可以做什么
  • 检查版本、配置语法、解析出的虚拟主机、已加载与编译模块、构建选项及配置 include 树
  • 读取运行时配置以及静态模块中的指令
  • 获取可选的 mod_status 指标、有长度限制的错误日志尾部和不含隐私信息的访问日志状态摘要
  • 探测由运维方配置的 HTTP 健康地址，且不下载响应正文
  • 将各项检查汇总为一次诊断，失败时保留为错误
  • 执行 graceful reload，先做配置测试并支持 dry-run
适用场景
适合让助手在同一台机器上协助运维或排查 Apache HTTP Server：查看配置、模块、虚拟主机、状态指标和日志，或在修改配置后执行受控重载。
运行要求
以本地 stdio 进程在用户机器上运行（仅桌面端）。需要主机上安装 Python 3.11+、uv 和 apachectl，并需配置文件列出目标：apachectl 路径、可选的探测与 mod_status 地址、错误与访问日志路径、超时和 TLS 设置。未声明账号、API 密钥或环境变量。
安装前请注意
graceful reload 会改动线上服务器状态：它先运行 configtest，支持 dry-run 和两次 CLI 确认，但最终结果可能未知，且未快照旧配置时没有安全的回滚方式。它会读取本地错误与访问日志，日志路径需谨慎选择。虚拟主机编辑、TLS 证书管理和模块变更不在本版本范围内。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Apache HTTP Server AIops，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

Apache AIops

A dedicated, governed MCP server, CLI and skill for Apache HTTP Server with 17 MCP tools. It uses Apache's own apachectl diagnostics, optional operator-configured HTTP health and mod_status URLs, and bounded reads of an operator-configured error log plus a privacy-preserving access-log status summary. Every call is audited and budgeted by the vendored governance harness.

What it checks

  • Apache version, config syntax, parsed virtual hosts and loaded modules.
  • Build options and parsed runtime configuration.
  • Parsed config include tree, compiled modules and directives from static modules.
  • Optional machine-readable mod_status metrics, bounded error-log tail and privacy-preserving access-status summary.
  • Optional HTTP health status without downloading the response body.
  • apache_diagnose correlates the checks and preserves failures as errors with data: null.

Setup from source

Requires Python 3.11+, uv, and apachectl on the operator host. Run uv sync --dev, uv run apache-aiops init, then uv run apache-aiops doctor. Manual ~/.apache-aiops/config.yaml:

yaml
targets:  - name: local    apachectl_bin: apachectl    probe_url: http://127.0.0.1/health    status_url: http://127.0.0.1/server-status?auto    error_log: /var/log/apache2/error.log    access_log: /var/log/apache2/access.log    timeout: 10    verify_ssl: true

Run uv run apache-aiops diagnose. The MCP entry point is uv run apache-aiops-mcp. The optional HTTP probe is configured by the operator, not chosen by a tool caller. TLS verification is enabled by default, and ca_file accepts a custom CA PEM.

Scope and verification

graceful-reload first runs configtest, supports dry-run and two CLI confirmations, and reports an unknown final outcome even if the command returned: existing workers may still serve the old config. It has no safe inverse when the prior config file is not snapshotted. Vhost editing, TLS certificate management and module changes remain outside this release. See verification. Missing operations and live-environment feedback are welcome as issues or PRs.

来源：README.md，提交 a0092fa

工具

0
SourceWeft 曾在隔离沙箱中以无凭据方式启动该软件包一次，以列出其工具，但未能完成：服务器未能启动。

版本历史

1
  1. v0.2.0最新Nov 5, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分