MCP Variance Log

基本能力

产品定位

MCP Variance Log 是一个用于监控和记录对话中异常事件的工具，旨在帮助开发者或研究人员分析和理解对话中的异常模式。

核心功能

1. 自动日志记录：监控每次交互，当检测到中等或低概率事件时，自动记录到数据库。
2. 数据分析：提供多种查询工具，如 read-logs、read_query 等，用于查看和分析日志数据。
3. 数据库管理：支持创建表、描述表结构等数据库操作。
4. 概率分类：将事件分为 HIGH、MEDIUM 和 LOW 三类，分别对应不同的记录优先级。

适用场景

1. 对话监控：用于监控和分析对话中的异常或低概率事件。
2. 数据分析：适用于需要统计和分析对话模式的研究或开发场景。
3. 调试与优化：帮助开发者识别和优化对话系统中的潜在问题。

工具列表

1. Monitoring
2. log-query：跟踪对话模式，记录异常事件。
3. Query
4. read-logs：查看日志并进行过滤。
5. read_query：执行 SELECT 查询。
6. write_query：执行 INSERT/UPDATE/DELETE 操作。
7. create_table：创建表。
8. list_tables：显示所有表。
9. describe_table：显示表结构。

常见问题解答

1. 数据库访问问题：
2. 检查文件权限和路径配置。
3. 确保 /data 目录存在。
4. 安装问题：
5. 确保安装了 MCP ≥1.2.0 和 UV。
6. 如果 UV 未找到，请重新安装。
7. 配置问题：
8. 检查 config.json 的语法和路径分隔符（Windows 使用 \\）。

使用教程

使用依赖

1. 确保已安装 Python ≥3.10 和 SQLite3。
2. 安装 UV（Python 包安装和环境管理器）： ```bash # 使用 pip（推荐 Windows） pip install uv

# 使用安装脚本（Linux/MacOS） curl -LsSf https://astral.sh/uv/install.sh | sh ```

安装教程

1. 克隆并安装： bash git clone https://github.com/truaxki/mcp-variance-log.git cd mcp-variance-log uv pip install -e .
2. 配置 Claude Desktop：
3. 修改 claude_desktop_config.json 文件，添加以下内容： json { "mcpServers": { "mcp-variance-log": { "command": "uv", "args": [ "--directory", "PATH_TO_REPO/mcp-variance-log", "run", "mcp-variance-log" ] } } }
4. 配置文件路径：
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
   • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Linux: ~/.config/Claude/claude_desktop_config.json

调试方式

1. 启动服务后，检查日志文件是否正常生成。
2. 使用 read-logs 工具查看日志数据，确认记录是否正常。
3. 如果遇到问题，参考常见问题解答部分进行排查。

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。