Aegis Cluster MCP

MCP运维云端

提供方 MichealBreedlove

运维云端 stdio · 本地进程 无需鉴权 社区 / 第三方 Claude
查看接入方式

一个允许Claude直接查询和操作基础设施的MCP服务器,提供对Aegis家庭实验室集群各层的访问,包括Proxmox虚拟机、TrueNAS存储、OPNsense防火墙等。

一句话选型结论

按资料字段整理

Aegis Cluster MCP 属于运维云端类 MCP 服务器,stdio · 本地进程,无需鉴权,可直接接入 Claude,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类运维云端 传输方式stdio · 本地进程 鉴权无需鉴权 部署方式本地部署
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 19 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

运维云端
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量19暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

集群管理Python本地部署基础设施自动化网络安全监控工具API集成

安装与配置

stdio · 本地进程 无需鉴权
客户端在本机拉起子进程,数据不出本机
pip install -e .

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js 等运行时,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 19 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
云资源查询

查实例、存储、账单等云上资源状态。

部署与发布

把部署、重启、回滚这类操作接进对话。

监控与告警

拉取监控指标,异常时让模型帮你判断。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 19 个工具,覆盖面较广,能满足多种调用。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在运维云端场景里让模型直接调用外部能力的人。
  • 已经在用 Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Aegis Cluster MCP当前 19 stdio · 本地进程 本地部署 有 2026-05-17
lobehub 未标注 stdio · 本地进程 本地部署 有 2026-04-11
TrendRadar 未标注 stdio · 本地进程 本地部署 有 2026-04-13
Ui Tars Desktop 8a825770 未标注 stdio · 本地进程 本地部署 有 2026-05-17
ruflo 未标注 stdio · 本地进程 本地部署 有 2026-04-13
FastGPT 未标注 stdio · 本地进程 本地部署 有 2026-04-11

服务器档案

运维云端
字段来自项目仓库与公开索引,中文说明由本站标注
提供方MichealBreedlove上游标注的维护方 MichealBreedlove
分类运维云端本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

10.3 KB
来自项目仓库与上游目录的原文,未做删改

神盾集群mcp

MCP(模型上下文协议)服务器,使Claude本机工具能够访问Aegis家庭实验室集群的每一层——Proxmox管理程序、TrueNAS存储、OPNsense防火墙、Prometheus警报、Wazuh SIEM和OpenClaw代理VM。

由Micheal Breedlove构建,既是生产运营工具,也是网络安全/基础设施工程组合。


这是什么

该服务器允许Claude,而不是将API输出复制到Claude中 直接查询您的基础架构并对其采取行动 作为原生MCP工具。你用简单的英语问了一个问题;Claude调用正确的工具,解析响应,并给出基于实时集群状态的答案。

6个子系统中的20个工具:

子系统 工具
Proxmox(新星/米拉/奥林) get_cluster_health, get_node_status, get_proxmox_alerts, list_vms, get_vm_status, restart_vm, get_vm_logs
TrueNAS比例尺 get_zfs_pools, get_zfs_datasets, get_truenas_alerts
NFS/SSH check_nfs_mounts, get_agent_status, get_agent_logs
OPNsense get_opnsense_status, get_dns_entries
普罗米修斯 get_prometheus_alerts, get_prometheus_targets
瓦祖 get_wazuh_agents, get_recent_alerts

快速开始

1.克隆并安装```bash

git clone https://github.com/yourusername/aegis-cluster-mcp.git
cd aegis-cluster-mcp
pip install -e .


### 2.配置凭据```bash
cp config/.env.example config/.env
# Edit config/.env with your actual credentials

3.用克劳德代码注册```bash

claude mcp add aegis-cluster --command aegis-mcp


或添加到您的 `~/.claude/mcp_servers.json` 手动:```json
{
"aegis-cluster": {
"command": "aegis-mcp",
"env": {
"PROXMOX_TOKEN_SECRET": "your-secret-here",
"TRUENAS_API_KEY": "your-key-here"
}
}
}

4.验证其是否正常工作

在克劳德代码中:```
Use get_cluster_health to check the status of all three Proxmox nodes.


______________________________________________________________________

## 环境变量参考

所有凭据都是从环境变量中读取的。永远不要硬编码秘密。

### Proxmox

|变量|默认值|描述|
|---|---|---|
| `PROXMOX_NOVA_HOST` | `10.1.1.2` |Nova(PROXMOX-1)主机名/IP|
| `PROXMOX_MIRA_HOST` | `10.1.1.4` |Mira(PROXMOX-2)主机名/IP|
| `PROXMOX_ORIN_HOST` | `10.1.1.5` |Orin(PROXMOX-3)主机名/IP|
| `PROXMOX_PORT` | `8006` |Proxmox API端口|
| `PROXMOX_TOKEN_ID` |-|中的API令牌 `user@realm!tokenid` 格式|
| `PROXMOX_TOKEN_SECRET` |-| API令牌机密值|
| `PROXMOX_VERIFY_SSL` | `false` |验证TLS证书|

在Proxmox:Datacenter中创建API令牌→ API令牌→ Add.
所需的最小权限: `VM.Audit`, `Datastore.Audit`, `Sys.Audit`.

### TrueNAS

|变量|默认值|描述|
|---|---|---|
| `TRUENAS_HOST` | `10.1.1.11` |TrueNAS主机名/IP|
| `TRUENAS_API_KEY` |-|TrueNAS API密钥(凭据→ API密钥)|
| `TRUENAS_VERIFY_SSL` | `false` |验证TLS证书|

### OPNsense

|变量|默认值|描述|
|---|---|---|
| `OPNSENSE_HOST` | `10.1.1.1` |OPNsense主机名/IP|
| `OPNSENSE_API_KEY` |-| API密钥(系统→ 访问→ 用户→ Edit → API密钥)|
| `OPNSENSE_API_SECRET` |-| API机密|
| `OPNSENSE_VERIFY_SSL` | `false` |验证TLS证书|

### 普罗米修斯/格拉法纳

变量 · 默认值 · 描述
`PROMETHEUS_HOST` · `10.1.70.25` · 普罗米修斯主机名/IP
`PROMETHEUS_PORT` · `9090` · 普罗米修斯港
`GRAFANA_HOST` · `10.1.70.25` · Grafana主机名/IP
`GRAFANA_PORT` · `3000` 格拉夫港口。
`PROMETHEUS_USER` · _(空)_ · 可选基本身份验证用户
`PROMETHEUS_PASSWORD` · _(空)_ · 可选基本身份验证密码

### 瓦祖

|变量|默认值|描述|
|---|---|---|
| `WAZUH_HOST` | `10.1.1.26` |Wazuh管理器主机名/IP|
| `WAZUH_PORT` | `55000` |Wazuh API端口|
| `WAZUH_USER` | `wazuh` |API用户名|
| `WAZUH_PASSWORD` |-| API密码|
| `WAZUH_VERIFY_SSL` | `false` |验证TLS证书|

### OpenClaw代理虚拟机

|变量|默认值|描述|
|---|---|---|
| `AGENT_NOVA_HOST` | `10.1.20.21` |Nova代理VM IP|
| `AGENT_MIRA_HOST` | `10.1.20.22` |Mira代理VM IP|
| `AGENT_ORIN_HOST` | `10.1.20.23` |Orin代理VM IP|
| `AGENT_SSH_USER` | `openclaw` |SSH用户名|
| `AGENT_SSH_KEY_PATH` | _(空)_ |SSH私钥路径(推荐)|
| `AGENT_SSH_PASSWORD` | _(空)_ |SSH密码(不推荐)|
| `AGENT_SSH_PORT` | `22` |SSH端口|
| `SSH_TIMEOUT` | `10` |SSH连接超时(秒)|

### NFS挂载

|变量|默认值|描述|
|---|---|---|
| `NFS_NOVA_HOST` | `10.1.1.2` |NFS实时挂载的主机(Nova)|
| `NFS_MOUNT_OPENCLAW` | `/mnt/openclaw` |OpenClaw NFS装载路径|
| `NFS_MOUNT_SHARED` | `/mnt/openclaw-shared` |共享NFS装载路径|
| `NFS_SERVER` | `10.1.40.11` |NFS服务器IP|

### 将军

|变量|默认值|描述|
|---|---|---|
| `LOG_LEVEL` | `INFO` |日志记录级别:调试、信息、警告、错误|
| `HTTP_TIMEOUT` | `30` |HTTP请求超时(秒)|

______________________________________________________________________

## 克劳德互动示例

### 上午集群检查

> **你:** 检查群集运行状况,并告诉我是否需要注意。

克劳德打电话来 `get_cluster_health()` → `get_proxmox_alerts()` → `get_truenas_alerts()` → `get_prometheus_alerts()` 并为您提供一份包含可操作项目的综合状态报告。

______________________________________________________________________

### NFS挂载调试

> **你:** openclaw NFS装载再次失败。你能检查一下并告诉我怎么了吗?

克劳德打电话来 `check_nfs_mounts()` 它测试两个挂载的实际读/写I/O,检测过时的NFS句柄、卸载错误和权限错误,并建议正确的补救措施。

______________________________________________________________________

### 安全分流

> **你:** 显示集群中过去6小时的任何关键Wazuh警报。

克劳德打电话来 `get_recent_alerts(hours=6)` 和 `get_wazuh_agents()` 为了交叉引用连接的代理,然后根据代理上下文按严重程度总结警报。

______________________________________________________________________

### VM故障排除

> **你:** mira上的VM 105似乎很慢。它当前的CPU和内存使用情况如何?

克劳德打电话来 `get_vm_status(node="mira", vmid=105)` 并返回详细的资源利用率。如果您要求它重新启动:“在mira上重新启动VM 105”→ 克劳德打电话来 `restart_vm` 和 `confirm=False` 首先,向您显示确认请求,然后用重新呼叫 `confirm=True` 只有在你批准之后。

______________________________________________________________________

### 基础设施审计

> **你:** 给我一份nova上运行的所有东西的完整清单。

克劳德打电话来 `list_vms(node="nova")` 并返回每个VM和容器的状态、CPU、内存和正常运行时间,这些数据与您从中获得的数据相同 `pvesh get /nodes/pve/qemu` 但无需离开您的聊天窗口。

______________________________________________________________________

### 普罗米修斯警报路由

> **你:** 普罗米修斯当前正在触发哪些警报,哪些节点受到影响?

克劳德打电话来 `get_prometheus_alerts()` → 交叉引用实例 `get_prometheus_targets()` → 通过IP将警报实例映射回集群节点。

______________________________________________________________________

## 安全模型

**默认情况下为只读。** 所有查询工具(除 `restart_vm`)是非破坏性的GET操作。他们无法修改群集状态。

**破坏性操作需要明确确认。** `restart_vm` 将拒绝执行,除非 `confirm=True` 明确传递。当Claude在没有确认的情况下调用此工具时,它会收到一个错误响应,提示它先与您确认——Claude将在聊天中向您显示确认。

**凭证永远不会离开你的机器。** 所有API令牌、密码和SSH密钥都是从运行MCP服务器的机器上的环境变量加载的。它们从未被发送到Anthropic或存储在克劳德的上下文中。

**最小特权原则。** 每个子系统使用所需的最低API权限:

- Proxmox: `VM.Audit` + `Datastore.Audit` + `Sys.Audit` (只读令牌)
- TrueNAS:只读API密钥
- OPNsense:只读API用户
- 瓦祖: `agents:read` + `alerts:read` 权限

**没有出站连接。** 服务器仅与您的本地集群IP进行通信。没有数据离开您的网络。

______________________________________________________________________

## 发展

### 运行测试```bash
pip install -e ".[dev]"
pytest tests/ -v

项目结构```

aegis-cluster-mcp/
├── src/aegis_mcp/
│ ├── server.py # MCP server, tool registration, dispatch
│ ├── proxmox.py # Proxmox API client (proxmoxer)
│ ├── truenas.py # TrueNAS API client (httpx)
│ ├── opnsense.py # OPNsense API client (httpx)
│ ├── prometheus.py # Prometheus API client (httpx)
│ ├── wazuh.py # Wazuh API client (httpx + JWT auth)
│ └── ssh_health.py # SSH health checks (paramiko)
├── config/
│ └── .env.example # Credential reference
├── docs/
│ └── tools.md # Full tool reference with example output
├── tests/
│ └── test_tools.py # Unit tests with mocked responses
└── pyproject.toml
```

添加新工具

  1. 将实现功能添加到相关模块中(proxmox.py, truenas.py等等)
  2. 在中注册该工具 server.py --添加到 TOOLS 在中列出并添加调度案例 call_tool()
  3. 将测试添加到 tests/test_tools.py
  4. 文档在 docs/tools.md

集群参考

主机 · IP · 角色
新星(PROXMOX-1) · 10.1.1.2 · 主Proxmox节点,TrueNAS主机
米拉(PROXMOX-2) · 10.1.1.4 · Proxmox节点
奥林(PROXMOX-3) · 10.1.1.5 · Proxmox节点
TrueNAS。 10.1.1.11 · ZFS存储(Nova上的VM 200)
OPNsense · 10.1.1.1 · 防火墙/网关
普罗米修斯/格拉法纳 · 10.1.70.25 · 监控堆栈
瓦祖 · 10.1.1.26 ,SIEM 。
Nova探员 · 10.1.20.21 · Nova上的OpenClaw代理VM
米拉探员 · 10.1.20.22 · Mira上的OpenClaw代理VM
奥特工 · 10.1.20.23 · Orin上的OpenClaw代理VM
贾斯珀 · 10.1.1.150 · 游戏PC,运行OpenClaw主代理
NFS服务器 · 10.1.40.11 · NFS存储服务器


许可证

麻省理工学院

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Aegis Cluster MCP 怎么安装?

在客户端按下面的安装命令接入:pip install -e .。装完在客户端配置里引用同一个包或端点。

Aegis Cluster MCP 怎么在 Claude 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Aegis Cluster MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Aegis Cluster MCP 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

Aegis Cluster MCP 支持哪些客户端?

资料标注支持 Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Aegis Cluster MCP 能提供哪些能力?

资料显示约 19 个工具;能力标签包括 集群管理、安全、Python、Claude。具体工具清单以官方文档为准。

Aegis Cluster MCP 需要什么运行环境?

属于本地进程,需要在本机装好运行环境。

Aegis Cluster MCP 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。