MCP Variance Log

🚀 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 という相対パスにあります。

🚀 クイックスタート

MCP Variance Log は、会話パターンの監視と記録を行うツールです。このツールを使用することで、会話の異常パターンや重要なイベントを把握することができます。

✨ 主な機能

• 会話パターンの監視：高、中、低の優先度で会話パターンを追跡し、必要に応じて記録します。
• 多様なクエリ機能：ログの表示、フィルタリング、テーブルの作成や管理など、さまざまな操作が可能です。

📦 インストール

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

問題解決

データベースアクセスの問題

• エラー：「データベースに接続できません」
  • ファイルの権限を確認してください。
  • パスの設定が正しいことを確認してください。
  • /data ディレクトリが存在することを確認してください。

インストールの問題

• エラー：「モジュール 'mcp' が見つかりません」
  • 以下のコマンドを実行してください：uv pip install mcp>=1.2.0
• エラー：「UV コマンドが見つかりません」
  • UV をインストールしてください：curl -LsSf https://astral.sh/uv/install.sh | sh

設定の問題

• エラー：「MCP サービスを起動できません」
  • 設定ファイルの構文を確認してください。
  • パスの区切り文字が正しいことを確認してください（Windows ではバックスラッシュを使用）。
  • UV ツールがシステムの PATH に含まれていることを確認してください。

貢献方法

1. リポジトリをフォークします。
2. 機能ブランチを作成します。
3. プルリクエストを送信します。

📄 ライセンス

このプロジェクトは MIT License の下でライセンスされています。

サポート

問題が発生した場合は、GitHub Issues でフィードバックを送信してください。