MCP 方差日志

项目概述

MCP Variance Log 是一个用于监控和记录对话模式的工具，支持以下功能：

• 监测：跟踪对话模式

  • 高优先级（不记录）：常见交互
  • 中等优先级（记录）：异常模式
  • 低优先级（紧急情况）：关键事件

• 查询：

  • log-query：查看日志
  • read-logs：筛选日志
  • read_query：执行 SELECT 查询
  • write_query：执行 INSERT/UPDATE/DELETE 操作
  • create_table：创建表
  • list_tables：显示所有表
  • describe_table：显示表结构

数据库文件位于安装目录的 data/varlog.db 相对路径下。

安装说明

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 提交反馈。