使用说明
mcp服务器日志筛选
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.
提供程序身份验证和环境变量
请参阅特定于提供商的设置和身份验证文档：
对于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 <trace-id>
mcp-server-logs-sieve sources --provider gcp --scope my-project
文档
贡献
欢迎捐款。
