Logs Sieve

mcp服务器日志筛选

](https://www.npmjs.com/package/mcp-server-logs-sieve) ](https://www.npmjs.com/package/mcp-server-logs-sieve)    

mcp-server-logs-sieve 是一个MCP服务器，允许AI助手直接从您的可观察性后端查询日志。

用简单的语言问调试问题，让Logs-Sieve为您提取确切的日志和上下文。

为什么存在

在事件发生时，很多时间都会进入重复步骤：

• 查找正确的日志源
• 缩小时间窗口
• 发现重复出现的故障模式
• 跨服务跟踪

Logs-Sieve将这些工作流打包成四个工具： query_logs, summarize_logs, trace_request，以及 list_log_sources.

支持的提供商

• 谷歌云日志(gcp)
• AWS CloudWatch日志(aws)
• Azure监控日志(azure)
• 格拉法娜·洛基(loki)
• Elasticsearch(elasticsearch)

先决条件

⚠️ 需要Node.js 20或更高版本。 此包使用需要Node.js 20+的ES模块和依赖项。如果你看到 ERR_MODULE_NOT_FOUND 错误，请检查您的Node版本 node -v 并在需要时进行升级。 这适用于您是否通过 npx、全局安装或从源代码使用。

快速MCP配置

示例 .mcp.json:

{
  "mcpServers": {
    "logs-sieve": {
      "command": "npx",
      "args": ["-y", "mcp-server-logs-sieve@latest", "--provider", "gcp"]
    }
  }
}

如果你直接从这个仓库源运行，你仍然可以使用 node ./bin/mcp-server-logs-sieve.js --provider gcp.

首次设置： 在第一次使用时， npx 需要下载并安装该软件包（~40s）。Claude Code可能会超时等待。在将缓存添加到MCP配置之前，在终端中运行以下命令一次以对缓存进行预充：

npx mcp-server-logs-sieve@latest --provider gcp
# (Ctrl+C once it starts — you just need the install to complete)

之后，Claude Code将立即从npx缓存启动服务器。

更新配置后，重新启动MCP客户端并用确认 /mcp.

提供程序身份验证和环境变量

请参阅特定于提供商的设置和身份验证文档：

• 谷歌云平台
• 亚马逊云服务
• Azure
• 洛基
• Elasticsearch

对于Elasticsearch API兼容性头：

export ELASTICSEARCH_COMPAT_VERSION=8

CLI使用情况

该软件包还包括一个用于直接终端使用的CLI：

mcp-server-logs-sieve query --provider gcp --scope my-project --last 1h --filter "payment failed"
mcp-server-logs-sieve summarize --provider gcp --scope my-project --last 24h
mcp-server-logs-sieve trace --provider gcp --scope my-project --trace 
mcp-server-logs-sieve sources --provider gcp --scope my-project

文档

• 文档主页
• 入门
• MCP客户端设置（克劳德代码、克劳德桌面、光标、Windsurf）
• 工具参考
• 故障排除
• 兼容性矩阵

贡献

欢迎捐款。

• 从这里开始： 贡献.md
• 问题：
• 讨论：