Seq MCP 服务器

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

功能

工具

信号管理

• get_signals - 获取带有过滤选项的信号

  • 按所有者 ID 过滤

  • 过滤共享/私有信号

  • 支持部分匹配

事件管理

• get_events - 获取带有丰富过滤选项的事件

  • 按信号 ID 过滤

  • 自定义过滤表达式

  • 可配置的事件数量（最多 50 个）

  • 灵活的时间范围选项

  • 日期范围过滤

警报管理

• get_alert_state - 获取警报的当前状态

资源

信号列表

• signals - 列出所有带有详细信息的共享信号

  • 信号 ID

  • 标题

  • 描述

  • 共享状态

  • 所有者信息

Related MCP server: MCP Server

配置

该服务器需要以下环境变量：

• SEQ_BASE_URL (可选)：您的 Seq 服务器 URL（默认为 'http://localhost:8080'）

• SEQ_API_KEY (必需)：您的 Seq API 密钥

seq-ops 技能

此仓库包含一个用于 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 Code 一起使用

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

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 以避免“Connection closed”错误。

通过在 Claude Code 中运行 /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 - 最近 1 分钟

• 15m - 最近 15 分钟

• 30m - 最近 30 分钟

• 1h - 最近 1 小时

• 2h - 最近 2 小时

• 6h - 最近 6 小时

• 12h - 最近 12 小时

• 1d - 最近 1 天

• 7d - 最近 7 天

• 14d - 最近 14 天

• 30d - 最近 30 天

安装

通过 npm 全局安装：

npm install -g mcp-seq

或者直接使用 npx —— 无需安装（如上面的配置示例所示）。

调试

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

npm run test-script

类型安全

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

• 用于静态类型检查的 TypeScript

• 用于运行时类型检查的 Zod 模式验证

• 适当的错误处理和响应格式化