Komari-MCP-Server：让 AI 直接读懂你的服务器状态

为什么搞这个

现在越来越多工作流里都接了 AI——写代码、查文档、分析日志，基本上能交给 AI 的事都交给 AI 了。但服务器监控这块还是个断层：你得自己打开面板，翻节点列表，然后把数据喂给 AI 分析。

不如直接让 AI 自己去查。

Komari-MCP-Server 就是干这个的。把 Komari 的 API 包装成 MCP 工具，AI 客户端直接调就行。问一句”xx 节点挂了没”，AI 自己去 Komari 拉数据、算负载、告诉你结果，整个流程不用你手动中转。

先看看效果

接入 AstrBot 后，Telegram/Discord 里直接跟 AI 聊就行：

WorkBuddy 桌面客户端也一样：

能干什么

一共 7 个工具，基本上 Komari 面板上能看的数据，这里都能查：

工具	作用	要 API Key 吗
`komari_get_public_info`	站点基本信息（名称、主题之类的）	不用
`komari_get_version`	Komari 服务端版本号	不用
`komari_get_nodes`	节点配置（CPU、内存、系统啥的）	不用
`komari_get_latest_status`	实时状态（CPU、内存、在线没在线）	不用
`komari_get_recent_status`	最近一分钟的状态记录	不用
`komari_get_records`	历史负载或者 Ping 数据	不用
`komari_get_full_nodes_status`	一次返回配置 + 实时状态	不用

不用配 API Key 也能用，只是隐藏的节点数据拿不到。配上 Key 就全解锁了。

注意：API Key 会把节点 IP、端口这些敏感信息也返回给 AI，所以客户端那边得是你信任的。

怎么部署

方式一：本地运行

编译完直接跑，配合 WorkBuddy、Claude Desktop 之类的本地客户端：

go build -o komari-mcp.exe ./cmd/server

export KOMARI_BASE_URL="https://你的komari地址"
export KOMARI_API_KEY="你的key"
./komari-mcp.exe

客户端配置里加上：

{
  "mcpServers": {
    "komari": {
      "command": "C:\\path\\to\\komari-mcp.exe",
      "env": {
        "KOMARI_BASE_URL": "https://你的komari地址",
        "KOMARI_API_KEY": "你的key"
      }
    }
  }
}

方式二：远程 HTTP

部署在服务器上，多个客户端共用。HTTP POST 和 WebSocket 都支持：

export KOMARI_BASE_URL="https://你的komari地址"
export KOMARI_API_KEY="你的key"
export KOMARI_TRANSPORT="http"
export KOMARI_HTTP_ADDR=":8080"

./komari-mcp

客户端通过 URL 连：

{
  "mcpServers": {
    "komari-remote": {
      "url": "http://你的服务器:8080/mcp",
      "transport": "streamable-http"
    }
  }
}

方式三：Docker

直接使用编排文件：

services:
  komari-mcp:
    image: ghcr.io/mogumc/komari-mcp-server:latest
    container_name: komari-mcp
    environment:
      - KOMARI_BASE_URL=${KOMARI_BASE_URL:?KOMARI_BASE_URL is required}
      - KOMARI_API_KEY=${KOMARI_API_KEY:?KOMARI_API_KEY is required}
      - KOMARI_TRANSPORT=http
      - KOMARI_HTTP_ADDR=:8080
    ports:
      - "8080:8080"
    restart: unless-stopped

技术细节

使用用 Go 编写。

代码结构很简单：

komari-mcp-server/
├── cmd/server/main.go       # MCP 协议处理、HTTP/stdio 传输
├── internal/komari/client.go # 封装 Komari 的 RPC2 调用
├── internal/rpc2/types.go    # 数据结构定义
├── Dockerfile
└── docker-compose.yml

实际使用场景

告警来了，Telegram 里问一句就完事，AI 自己去查、自己分析
多台机器的状态对比，不用来回切页面，一句话搞定
让 AI 看历史负载趋势，发现异常模式

下载

GitHub 地址：github.com/mogumc/komari-mcp-server

你可以直接在 Release 下载适用于 Windows/Linux/Mac 的预编译二进制内容。

MoGuQAQ's blog