项目简介

Variance Log 是一个基于 Model Context Protocol (MCP) 构建的服务器应用，旨在与 Claude Desktop 等 MCP 客户端配合使用。它通过监控对话结构中的统计变异，自动检测并记录不寻常的对话事件到本地 SQLite 数据库。这使得用户可以追踪和分析对话中的异常模式，例如用户提出的不寻常声明或系统出现的意外行为。

主要功能点

自动对话监控: 持续监控对话交互，无需手动干预。
异常事件日志: 根据预设的概率分类（高、中、低），自动记录被认为是“中”或“低”概率的异常事件。
详细日志信息: 记录包括用户ID、会话ID、交互类型、概率分类、消息内容、上下文总结和推理等详细信息。
数据查询工具: 提供多种工具查询和管理日志数据，包括：
- 'read-logs': 查看最近的日志记录，可以限制数量和按日期范围过滤。
- 'read_query': 执行自定义 SQL SELECT 查询，灵活检索日志数据。
- 'write_query', 'create_table', 'list_tables', 'describe_table': 提供数据库管理的工具，允许执行非SELECT查询、创建表、列出表和描述表结构。
SQLite 数据库: 使用本地 SQLite 数据库 'varlog.db' 存储日志数据，数据存储在本地，方便管理和分析。

安装步骤

环境准备: 确保已安装 Python 3.10 或更高版本，并安装了 'uv' 包管理器。如果未安装 'uv'，可以根据仓库 README 中的指引进行安装。

# 使用 pip 安装 uv (推荐 Windows 用户)
pip install uv

# 使用安装脚本安装 uv (Linux/MacOS 用户)
curl -LsSf https://astral.sh/uv/install.sh | sh

克隆仓库并安装: 从 GitHub 克隆 Variance Log 仓库到本地，并使用 'uv' 安装项目依赖。

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

服务器配置

要将 Variance Log MCP 服务器添加到 Claude Desktop，需要编辑 Claude Desktop 的配置文件 'claude_desktop_config.json'。

配置文件路径:

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

在 'claude_desktop_config.json' 文件中的 '"mcpServers"' 部分添加以下配置信息。请务必将 'PATH_TO_REPO/mcp-variance-log' 替换为 您本地仓库的实际路径。

{
  "mcpServers": {
    "mcp-variance-log": {
      "command": "uv",
      "args": [
        "--directory",
        "PATH_TO_REPO/mcp-variance-log",  // 替换为您的仓库路径，例如 "C:\\Users\\username\\source\\repos\\mcp-variance-log" (Windows) 或 "/Users/username/Documents/mcp-variance-log" (MacOS/Linux)
        "run",
        "mcp-variance-log"
      ]
    }
  }
}

配置参数说明:

'"mcp-variance-log"': 服务器名称，在 Claude Desktop 偏好设置中会用到。
'"command": "uv"': 启动服务器的命令，这里使用 'uv' 运行 Python 程序。
'"args"': 命令参数列表：
- '"--directory", "PATH_TO_REPO/mcp-variance-log"': 指定仓库根目录，'uv' 将在该目录下查找并运行程序。
- '"run", "mcp-variance-log"': 使用 'uv run' 命令运行 'mcp-variance-log' 程序，这会执行 'src/mcp_variance_log/init.py' 文件中的 'main()' 函数，从而启动 MCP 服务器。

配置完成后，重启 Claude Desktop 使配置生效。

基本使用方法

在 Claude Desktop 中启用: 打开 Claude Desktop 的偏好设置，找到 MCP 服务器配置部分，启用名为 "mcp-variance-log" 的服务器。
配置触发条件: 在 Claude Desktop 中，您可以设置何时使用 "mcp-variance-log" 工具来记录日志。例如，您可以配置在检测到 "MEDIUM" 或 "LOW" 概率事件时自动使用该工具。
对话交互: 正常与 Claude Desktop 进行对话。当出现符合触发条件的对话事件时，Variance Log 服务器会自动记录相关信息到 'varlog.db' 数据库中。
查询日志: 您可以在 Claude Desktop 中使用 'read-logs' 或 'read_query' 等工具来查询和查看已记录的日志。例如，您可以输入 'Read-logs from this morning' 或 'Can you search the logs for entry 29?' 等指令来查询日志数据。

通过以上步骤，您就可以使用 Variance Log MCP 服务器来监控和分析您的 Claude Desktop 对话交互了。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息