Seq MCP Server

Seq MCP Server

site icon
2025.04.04 0
TypeScript日志服务监控系统开发效率
Seq MCP Server 是一个通过 Model Context Protocol 提供对 Seq API 端点全面访问的服务,主要用于日志记录和监控系统。它允许用户通过多种工具管理信号、事件和警报,支持丰富的过滤选项和时间范围设置。
View on GitHub

Overview

基本能力

产品定位

Seq MCP Server 是一个中间件服务,旨在通过 MCP 协议提供对 Seq 日志和监控系统 API 的全面访问。

核心功能

  • 信号管理:支持获取信号,可按所有者 ID、共享/私有状态以及部分匹配进行过滤。
  • 事件管理:支持获取事件,提供多种过滤选项,包括信号 ID、自定义过滤表达式、事件数量限制(最多 100 个)以及灵活的时间范围设置。
  • 警报管理:支持获取警报的当前状态。
  • 资源列表:列出所有共享信号的详细信息,包括信号 ID、标题、描述、共享状态和所有者信息。

适用场景

  • 日志分析和监控系统的集成
  • 开发环境中的错误跟踪和调试
  • 生产环境中的实时监控和警报管理

工具列表

  • get-signals:获取信号,支持多种过滤选项。
  • get-events:获取事件,支持多种过滤选项和时间范围设置。
  • get-alertstate:获取警报的当前状态。
  • signals:列出所有共享信号的详细信息。

常见问题解答

  • 调试困难:由于 MCP 服务器通过 stdio 通信,调试可能具有挑战性。服务器实现了适当的错误处理和日志记录。
  • 类型安全:服务器使用 TypeScript 进行静态类型检查,Zod 模式验证进行运行时类型检查,以及适当的错误处理和响应格式化。

使用教程

使用依赖

安装 Node.js 和 npm。

安装教程

  1. 克隆或下载项目。
  2. 安装依赖:
npm install
  1. 构建服务器:
npm run build
  1. 配置环境变量:
  2. SEQ_BASE_URL(可选):Seq 服务器 URL(默认为 'http://localhost:8080')。
  3. SEQ_API_KEY(必需):Seq API 密钥。
  4. 在 Claude Desktop 配置文件中添加服务器配置:
{
  "mcpServers": {
    "seq": {
      "command": "/path/to/seq-server/build/seq-server.js",
      "env": {
        "SEQ_BASE_URL": "your-seq-url",
        "SEQ_API_KEY": "your-api-key"
      }
    }
  }
}

调试方式

  1. 运行测试脚本:
npm run test-script
  1. 开发模式下运行(自动重建):
npm run dev

许可证

该项目遵循 None 开源许可条款。