🚀 Seq MCP 服务器

Seq MCP 服务器提供 Seq 的 API 端点，用于与日志记录和监控系统交互。通过 Model Context Protocol，它能全面访问 Seq 的所有 API 功能。

✨ 主要特性

工具

信号管理

• get-signals - 获取信号，支持过滤选项：
  • 可按所有者 ID 过滤。
  • 能区分显示共享信号与私有信号。
  • 支持部分匹配。

事件管理

• get-events - 获取事件，带有丰富的过滤选项：
  • 可按信号 ID 过滤。
  • 支持自定义过滤表达式。
  • 可配置最大事件数（最多 100）。
  • 有灵活的时间范围选择，支持日期范围过滤。

警报管理

• get-alertstate - 获取当前警报状态。

资源

信号列表

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

📦 安装指南

该工具仍在开发中，尚未推送到 npm 仓库。您需要在本地克隆此仓库然后运行 npm run build。

要与 Claude Desktop 使用，请添加服务器配置：

• 在 MacOS 上：~/Library/Application Support/Claude/claude_desktop_config.json
• 在 Windows 上：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "seq": {
      "command":"node",
      "args": ["/Users/ahmadreza/source/ahmad2x4/mcp-server-seq/build/seq-server.js"],
      "env": {
        "SEQ_BASE_URL": "your-seq-url",
        "SEQ_API_KEY": "your-api-key"
      }
    }
  }
}

💻 使用示例

与 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"
      }
    }
  }
}

📚 详细文档

配置

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

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

时间范围选项

get-events 工具支持以下时间范围选项：

• 1m - 最近 1 分钟
• 15m - 最近 15 分钟
• 30m - 最近 30 分钟
• 1h - 最近 1 小时
• 2h - 最近 2 小时
• 6h - 最近 6 小时
• 12h - 最近 12 小时
• 1d - 最近 1 天
• 7d - 最近 7 天
• 14d - 最近 14 天
• 30d - 最近 30 天

调试

由于 MCP 服务器通过标准输入输出进行通信，调试可能具有挑战性。该服务器实现了完善的安全处理和日志记录功能。

🔧 技术细节

开发

安装依赖

npm install

构建服务器

npm run build

开发时自动重建

npm run dev

运行测试

npm run test-script