JinDaGe - mcp-server-seq MCP Details

article

README

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

📚 详细文档

配置

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

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

与 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 天

调试

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

mcp-server-seq