# Zabbix MCP Server（通用产品）v0.4.0

基于 [mpeirone/zabbix-mcp-server](https://github.com/mpeirone/zabbix-mcp-server) 源码增强（上游**未上架 PyPI**）。

| 项 | 值 |
|----|----|
| 文档 | [`VISION`](./VISION.md) · [`ROADMAP`](./ROADMAP.md) · [`CHANGELOG`](./CHANGELOG.md) · [`UPSTREAM`](./docs/UPSTREAM.md) |
| MCP | **`http://172.13.2.51:8000/mcp`** |
| Health | `http://172.13.2.51:8000/healthz` |
| Metrics | `http://172.13.2.51:8000/metrics` |
| 工具 | `host_brief` · `host_problems` · `zabbix_api` · `zabbix_api_docs` · `zabbix_api_list` |

## 启动

```bash
cd /opt/zabbix-mcp
cp -n .env.example .env
# ZABBIX_TOKEN=...
# MCP_HTTP_TOKEN=...   或  MCP_HTTP_TOKENS=alice:...,bob:...
docker compose up -d --build
```

依赖模型：

- **PyPI**：`requirements.txt`（`fastmcp` / `zabbix-utils` 等）构建时 `pip install`
- **上游 MCP 源码**：`./vendor/zabbix_mcp_server`（体积很小；用 `scripts/sync-upstream-vendor.sh` 更新）
- **本产品增强**：`./app`

## 任意 AI 接入

```json
{
  "mcpServers": {
    "zabbix": {
      "url": "http://172.13.2.51:8000/mcp",
      "headers": {
        "Authorization": "Bearer <token>"
      }
    }
  }
}
```

单机问诊优先 **`host_brief(ip)`**。

## 能力

| 能力 | 配置 |
|------|------|
| 只读 + 白名单 | `READ_ONLY` / `ZABBIX_API_WHITELIST` |
| 单/多 Token | `MCP_HTTP_TOKEN` / `MCP_HTTP_TOKENS` |
| 每客户端限流 | `MCP_RATE_LIMIT_PER_MIN` |
| CIDR | `ALLOWED_CIDRS` |
| 审计 | `MCP_AUDIT_LOG` |
| Prometheus | `GET /metrics` |
| 语义工具 | `MCP_SEMANTIC_TOOLS` |
| 上游同步 | `docs/UPSTREAM.md` |