日志监控API服务

Seq MCP Server是一个通过Model Context Protocol提供全面访问Seq API功能的日志监控系统交互服务,支持信号管理、事件管理和警报管理等功能。

  • by ahmad2x4
  • JavaScript
  • 本地部署
  • 13 星标
  • 更新于
在 GitHub 查看 ahmad2x4/mcp-server-seq

使用说明

Sequ MCP服务器

用于Seq的API端点的MCP服务器,用于与您的日志记录和监控系统交互。该服务器通过模型上下文协议提供对Seq的API功能的全面访问。

特性

工具

信号管理

  • get_signals -使用过滤选项获取信号
    • 按所有者ID筛选
    • 过滤共享/专用信号
    • 支持部分比赛

活动管理

  • get_events -使用广泛的筛选选项检索事件
    • 按信号ID过滤
    • 自定义筛选器表达式
    • 可配置的事件计数(最多50个)
    • 灵活的时间范围选项
    • 日期范围过滤

告警管理

  • get_alert_state -检索警报的当前状态

资源

信号列表

  • signals -列出所有共享信号及其详细信息
    • 信号ID
    • 标题
    • 描述
    • 共享状态
    • 所有者信息

配置

服务器需要以下环境变量:

  • SEQ_BASE_URL (可选):您的Seq服务器URL(默认为'http://localhost:8080')
  • SEQ_API_KEY (必需):您的Seq API密钥

seq-ops技能

此repo包括用于Seq日志分析和事件调查的Claude技能。一旦MCP服务器连接,该技能将指导Claude进行结构化调查——健康检查、事件分流、部署后监控——并生成一致、可操作的报告。

安装技能:

# From the releases page, download seq-ops.skill, then:
claude skill install seq-ops.skill

或者直接从这个仓库安装:

npx skills add ahmad2x4/mcp-server-seq

当你问“早上健康检查”、“产品有问题”、“检查日志是否超时”或“调查PPSR集成”等问题时,该技能会自动激活。


使用Claude代码

运行以下命令以添加服务器:

claude mcp add --transport stdio \
  --env SEQ_BASE_URL=http://localhost:5341 \
  --env SEQ_API_KEY=your-api-key \
  seq -- npx -y mcp-seq

要与您的团队共享配置,请使用 --scope project 标志(保存到 .mcp.json):

claude mcp add --transport stdio --scope project \
  --env SEQ_BASE_URL=http://localhost:5341 \
  --env SEQ_API_KEY=your-api-key \
  seq -- npx -y mcp-seq

Windows用户: 替换 npx -y mcp-seq 随着 cmd /c npx -y mcp-seq 以避免“连接已关闭”错误。

通过运行以下命令验证服务器是否已连接 /mcp 克劳德代码内部。

使用Claude Desktop

添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "seq": {
      "command": "npx",
      "args": ["-y", "mcp-seq"],
      "env": {
        "SEQ_BASE_URL": "your-seq-url",
        "SEQ_API_KEY": "your-api-key"
      }
    }
  }
}

发展

安装依赖项:

npm install

构建服务器:

npm run build

对于自动重建的开发:

npm run dev

运行测试:

npm run test-script

时间范围选项

这 get-events 该工具支持以下时间范围选项:

  • 1m -最后一分钟
  • 15m -最后15分钟
  • 30m -最后30分钟
  • 1h -最后一小时
  • 2h -过去2小时
  • 6h -过去6小时
  • 12h -过去12小时
  • 1d -最后一天
  • 7d -过去7天
  • 14d -过去14天
  • 30d -过去30天

安装

通过npm全局安装:

npm install -g mcp-seq

或直接与 npx --无需安装(如上述配置示例所示)。

调试

由于MCP服务器通过stdio进行通信,调试可能具有挑战性。服务器为所有操作实现了正确的错误处理和日志记录。您可以运行测试脚本来验证功能:

npm run test-script

类型安全

服务器通过以下方式实现了全面的类型安全:

  • TypeScript用于静态类型检查
  • 运行时类型检查的Zod模式验证
  • 正确的错误处理和响应格式