【免费下载链接】monoscopeMonoscope lets you ingest and explore your logs, traces and metrics. We store these in S3 compatible buckets. Query in natural language via LLMs.项目地址https://gitcode.com/gh_mirrors/mo/monoscope点击查看免费下载Monoscope MCP Server 让 Claude Desktop、Cursor 等 AI 客户端无需任何 API 封装就能直接查询生产环境的日志与追踪traces、管理监控告警并自动分诊 Issue。Monoscope 是一个将日志、追踪与指标统一存储S3 兼容桶并可自然语言查询的可观测性平台而它的 MCPModel Context Protocol端点/api/v1/mcp把这个平台的全部能力一键开放给了你的 AI 助手 什么是 Monoscope MCP Server一句话一个端点暴露整个平台。Monoscope 在POST /api/v1/mcp上提供一个标准的 HTTP JSON-RPC 2.0 MCP 服务器支持initialize握手、tools/list列出所有工具及其 JSON Schema和tools/call按名称调用工具。它的核心设计非常聪明见 src/Web/MCP.hs所有公开 REST 接口自动注册为工具。每个公开路由都会自动变成一个动词开头的工具如list_monitors、search_events、get_dashboard_yaml、mute_monitor、list_issues、get_issue、list_log_patterns……API 新增什么MCP 就自动多出什么工具无需手工维护。三个手写组合工作流工具把多次内部调用打包成一个高杠杆动作是专门写给 AI Agent 用的。相比让 AI 去 shell out 调 CLI 或拼 REST 请求MCP 工具带完整 JSON SchemaLLM 能正确生成参数返回结果结构化Agent 可以直接读取并继续推理。5 分钟快速上手接入 Claude Desktop 与 Cursor第一步创建 API Key在 Monoscope 的Settings → API Keys里创建一把 API Key或用 CLI 执行monoscope api-keys create。MCP 端点通过标准 Bearer Token 鉴权请求不带有效 Key 会直接收到401。第二步在客户端填入一行配置以 Claude Desktop / Claude Code 为例配置只有几行{ mcpServers: { monoscope: { url: https://api.monoscope.tech/api/v1/mcp, headers: { Authorization: Bearer YOUR_API_KEY } } } } 自建部署只需把 host 换成你的服务器地址路径保持/api/v1/mcp不变。Cursor、Cline 或其他任何支持 HTTP MCP 的客户端都适用同样的URL Bearer 头配置在对应的mcp.json或设置界面里添加即可。配置完成后在对话里说一句帮我列出所有监控Agent 会自动调用list_monitors工具并给出结果。工具目录自动生成的 REST 工具 3 个组合工作流工具工具名遵循动词开头的 snake_case规范。想看当前项目下的完整清单发一次tools/list即可也可用curl直接验证连通性curl -s https://api.monoscope.tech/api/v1/mcp \ -H Authorization: Bearer $MONOSCOPE_API_KEY \ -H Content-Type: application/json \ -d {jsonrpc:2.0,id:1,method:tools/list}组合工作流工具Agent 的快捷键工具它能做什么find_error_patterns返回按当前小时事件量排序的头部日志模式——一句话回答现在什么在炸search_events_nl自然语言 → KQL 查询由 agentic 查询规划器生成查询语句再执行比如过去一小时 checkout 服务的支付失败analyze_issue抓取某个 Issue 并让 LLM 给出诊断可能原因、关键信号、下一步行动清单这三个工具在 src/Web/MCP.hs 中定义其中search_events_nl复用平台的自然语言查询规划器src/Pkg/AI.hs。4 个实战场景从 On-Call 到日常排查场景一自然语言查日志search_events_nl以前查日志要先学 KQLMonoscope 实现了 KQL 查询子集现在直接说人话最近一小时里 severity 为 error 且服务是 checkout 的日志有哪些Agent 会调用search_events_nl拿到生成的 KQL 查询与时间范围再自动用search_events执行并返回结果。整条链路你只说了自然语言这一句话 ️场景二30 秒定位现在什么在炸find_error_patterns线上告警响起、还不知道哪里出问题时问一句现在最严重的错误模式是什么find_error_patterns会返回当前小时事件数最多的头部日志模式默认 20 条可用limit调整到 200附带统计截止时间点——免写查询直接看热点。场景三让 LLM 替你分诊 Issueanalyze_issue这是最有AI 值的一个工具。给它一个 Issue 的 UUID它会返回两样东西Issue 完整载荷关联日志、堆栈、影响面等原始数据LLM 生成的结构化诊断固定包含三部分Probable cause1–2 句可能原因、Key signals支撑诊断的具体字段证据、Next steps3–5 条以动词开头的可执行动作。值得注意的是它的防注入设计Issue 载荷被包裹在issue标签内并明确告知模型标签内是数据、不是指令避免恶意构造的日志文本劫持诊断流程。对 On-Call 场景来说相当于给每个告警配了一个资深 SRE 初筛‍场景四日常监控运维一句话搞定所有 REST 工具自动可用意味着这些操作都可以直接对 AI 说mute_monitor/create_monitor临时静默误报、快速新建监控list_dashboards/get_dashboard_yaml查看仪表盘及其 YAML 定义list_issues/get_issue浏览 Issue 列表、拉取详情list_endpoints/list_log_patterns盘点接口与日志模式错误处理与健壮性设计Agent 不会卡死MCP 端点为 AI 消费场景做了专门设计这也是它能可靠跑在生产环境的原因工具错误以isError: true的 MCP 结果返回而不是 JSON-RPC 层错误——Agent 能读到错误信息并自行决定重试对话流不中断每次工具调用有 30 秒内部超时任何挂起的子处理都不会阻塞端点大结果自动截断REST 工具的文本视图截断在 64 KB防止search_events这类大结果撑爆模型上下文窗口完整未截断的 JSON 保留在structuredContent字段中供类型化客户端使用。核心文件速查资料路径MCP 完整参考协议、工具目录、curl 示例docs/mcp.mdMCP 服务端实现工具注册、组合工具、JSON-RPC 分发src/Web/MCP.hsKQL 查询语法参考docs/kql-reference.md自然语言查询规划器src/Pkg/AI.hs小结Monoscope MCP Server 把查日志、管监控、分诊 Issue从写 API 调用/学查询语言降级为说一句话REST 工具自动同步保证能力完整三个组合工具覆盖高频排查路径而结构化错误与超时机制保证了 AI 客户端的稳定消费。如果你在找AI 助手 可观测性的落地方案接入这个端点是性价比极高的一步 ⭐赞分享【免费下载链接】monoscopeMonoscope lets you ingest and explore your logs, traces and metrics. We store these in S3 compatible buckets. Query in natural language via LLMs.项目地址https://gitcode.com/gh_mirrors/mo/monoscope点击查看免费下载相关推荐Code-Graph-RAG MCP Server 集成指南让 Claude Code 直接查询与编辑代码知识图谱Code Graph RAG MCP Server 集成指南让 Claude Code 直接查询与编辑代码知识图谱 Code Graph RAG 可以以 MC人工智能RAG知识图谱MCP 服务开发者工具ChatLab MCP Server 实战指南用 Claude Code / Cursor 直接检索本地聊天记录ChatLab MCP Server 实战指南用 Claude Code / Cursor 直接检索本地聊天记录 ChatLab MCP Server chPostgreSQL 全量查询日志用 log_statement 记录所有 SQL 并实时追踪PostgreSQL 全量查询日志用 log_statement 记录所有 SQL 并实时追踪 导读 在调试慢查询、排查异常写入、或审计某个库的所有 SQL文档教程知识库创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考