MCP Variance Log

🚀 MCP 方差日誌

MCP Variance Log 是一款用於監控和記錄對話模式的實用工具。它能夠對不同優先級的對話模式進行跟蹤，並提供豐富的查詢功能，幫助用戶更好地管理和分析對話日誌。

🚀 快速開始

MCP Variance Log 可對對話模式進行監測和記錄，支持多種查詢操作。數據庫文件存於安裝目錄的 data/varlog.db 相對路徑下。

✨ 主要特性

• 監測：對對話模式進行跟蹤，區分不同優先級的對話情況。
  • 高優先級（不記錄）：常見交互。
  • 中等優先級（記錄）：異常模式。
  • 低優先級（緊急情況）：關鍵事件。
• 查詢：提供多種查詢命令。
  • 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 提交反饋。