Mcp Server Seq

Seq 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 技能

此仓库包含一个用于 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 架构验证进行运行时类型检查
• 完善的错误处理和响应格式化