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:```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配置之前,在终端中运行以下命令一次以对缓存进行预充:```bash
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兼容性头:```bash
export ELASTICSEARCH_COMPAT_VERSION=8
## CLI使用情况
该软件包还包括一个用于直接终端使用的CLI:```bash
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
- 问题:
- 讨论:
