mcp
基于MCP协议的对话异常检测与日志系统
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:mcp。 它的用途是:基于MCP协议的对话异常检测与日志系统 详细介绍见:https://321skill.com/skills/mcp-mcp-variance-log/ 请根据该页面的说明完成安装。
使用示例
'请记录最近一次对话中出现的超时异常',variance-log 会自动检索 SQLite 数据库并返回对应时间戳、异常类型和会话上下文,帮助快速定位问题根源。
介绍
variance-log 是一个基于 MCP(Model Context Protocol)协议的对话异常检测日志系统,专门用于自动记录 AI 对话中的异常信息并持久化到 SQLite 数据库。它解决了开发者在调试和监控 AI 应用时,缺乏细粒度、结构化异常日志的问题。传统的日志系统往往只记录通用错误,而 variance-log 能够捕获对话上下文中诸如超时、无效响应、敏感内容触发等异常,并关联具体的对话片段,便于后续分析。
使用方式非常简单:通过 MCP 协议集成到你的 AI 开发环境(如 Claude Desktop、Cursor 等支持 MCP 的客户端)中,启动后即可自动监听对话流程。当检测到异常时,系统会将其时间、会话 ID、异常类型、原始消息等字段写入指定的 SQLite 文件,无需手动配置数据库或编写额外代码。
适合后端开发、运维工程师和测试工程师,特别是在开发 AI 客服、智能助手或需要审计对话质量的应用时。你可以在开发阶段用它快速定位 Bug,也可以在线上环境作为监控手段,留存合规记录。
使用建议:注意定期清理或归档 SQLite 数据库以避免文件过大;如果对话量极高,建议配合日志轮转策略;目前仅支持 SQLite 存储,若需要分布式数据库或云端存储,需自行扩展。
核心特点
与其他日志库不同,variance-log 专门针对 AI 对话场景设计,基于 MCP 协议原生集成,能自动捕获对话上下文中的异常,而不仅是通用错误日志。
注意事项
不适合非对话场景的通用日志记录,且仅支持 SQLite 存储,无法直接对接其他数据库或云日志服务。
常见问题
如何安装 variance-log?
执行 `npm install variance-log` 或从 GitHub 仓库 `git clone https://github.com/variance-log/mcp.git` 后运行 `npm install` 即可。
需要额外配置 MCP 服务器吗?
不需要复杂配置,只需在支持 MCP 的客户端(如 Claude Desktop)中注册该工具的路径即可,系统会自动监听对话并记录异常。