健康检查端点
GET /health —— 公开访问,无需认证。
status 的取值如下:
因此,
/health 适合用于存活和就绪探针。详见 src/controllers/healthController.ts。
进程内日志
MCPHub 维护一个滚动的进程内存日志缓冲区(src/services/logService.ts),供控制台的日志查看器使用。
日志流会为每个事件发送一行
data:,并包含初始的 { "type": "initial", "logs": [...] } 快照。以上三个端点都要求已认证的管理员权限(控制台 JWT、accessType: all 的 bearer key、OAuth token 或 Better Auth session)。
该缓冲区只存在于当前进程。在多实例部署中,请将 stdout 发送到日志聚合器,不要依赖此端点。
活动日志(数据库模式)
当 MCPHub 使用 PostgreSQL 运行时(参见数据库配置),每个 MCP 请求和响应都会由src/services/activityLoggingService.ts 持久化到 mcphub_activity 表。控制台通过以下端点提供访问:
在文件模式下,这些端点返回
404,控制台也会隐藏活动页面。
进程级指标
控制台通过getServerConnectionStats() 展示基础的服务器连接统计信息,该信息也嵌入在 /health 响应中。如需导出更丰富的进程指标,可以:
- 使用能够自动包装
http/express的 Node.js APM agent。 - 或从监控平台抓取
/health和/api/activities/stats。