MCP Variance Log

🚀 MCP 方差日志

MCP 方差日志是一款用于监控和记录对话模式的实用工具。它能够有效跟踪不同优先级的对话模式，并提供丰富的查询功能。其数据库文件存储于安装目录下，方便管理和使用。

🚀 快速开始

MCP Variance Log 主要具备监测和查询两大功能。监测功能可对不同优先级的对话模式进行跟踪，而查询功能则提供了多种命令，方便用户对日志进行查看、筛选和操作。

✨ 主要特性

• 监测：跟踪对话模式，根据优先级进行分类处理：
  • 高优先级（不记录）：常见交互。
  • 中等优先级（记录）：异常模式。
  • 低优先级（紧急情况）：关键事件。
• 查询：提供多种查询命令，满足不同的操作需求：
  • log-query：查看日志。
  • read-logs：筛选日志。
  • read_query：执行 SELECT 查询。
  • write_query：执行 INSERT/UPDATE/DELETE 操作。
  • create_table：创建表。
  • list_tables：显示所有表。
  • describe_table：显示表结构。

📦 安装指南

1. 确保安装 Python 3.10+ 和 UV 工具。
2. 克隆仓库并安装：

git clone https://github.com/truaxki/mcp-variance-log.git
cd mcp-variance-log
uv pip install -e .

📚 详细文档

配置说明

在 Claude Desktop 中配置 MCP 服务：

1. 打开 claude_desktop_config.json 文件，添加以下内容：

{
    "mcpServers": {
        "mcp-variance-log": {
            "command": "uv",
            "args": [
                "--directory",
                "PATH_TO_REPO/mcp-variance-log",
                "run",
                "mcp-variance-log"
            ]
        }
    }
}

2. 根据不同系统查找配置文件位置：

• Windows：%APPDATA%\Claude\claude_desktop_config.json
• MacOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Linux：~/.config/Claude/claude_desktop_config.json

问题排查

1. 数据库访问问题：

• 错误：“无法连接到数据库”
  • 检查文件权限。
  • 确认路径配置正确。
  • 确保 /data 目录存在。

2. 安装问题：

• 错误：“未找到模块‘mcp’”
  • 运行：uv pip install mcp>=1.2.0
• 错误：“未找到 UV 命令”
  • 安装 UV：curl -LsSf https://astral.sh/uv/install.sh | sh

3. 配置问题：

• 错误：“无法启动 MCP 服务”
  • 检查配置文件语法。
  • 确认路径分隔符正确（Windows 使用反斜杠）。
  • 确保 UV 工具在系统 PATH 中。

贡献指南

1. 叉取仓库。
2. 创建功能分支。
3. 提交拉取请求。

📄 许可证

本项目采用 MIT License。

💡 使用建议

如遇问题，请访问 GitHub Issues 提交反馈。