金大哥 - mcp-variance-log MCP 详情

article

README

🚀 MCP 方差日志

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

🚀 快速开始

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

✨ 主要特性

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

📦 安装指南

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

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

📚 详细文档

配置说明

在 Claude Desktop 中配置 MCP 服务：

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

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

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

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

问题排查

数据库访问问题：

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

安装问题：

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

配置问题：

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

贡献指南

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

📄 许可证

本项目采用 MIT License。

💡 使用建议

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

mcp-variance-log