AI Conversation Logger

# AI 会話ロガー MCP [English](./README.md) | [中文版](./README_zh.md) AI アシスタント専用に設計されたインテリジェントな MCP（Model Context Protocol）サーバーで、開発者との会話履歴を自動的に記録・管理します。 ## 🎯 主な機能 - **🤖 AI 駆動型ロギング** - すべてのコンテンツは AI アシスタントが決定・提供 - **📝 純粋な保存モード** - MCP はフォーマットと保存のみを担当、コンテンツの抽出や分析は行わない - **🔄 AI 回顧用設計** - プロジェクト履歴を AI が素早く理解できる最適化されたログ形式 - **🏷️ スマートな整理** - プロジェクトと日付で自動整理、タグ分類サポート - **🔍 強力な検索** - キーワード、ファイル、タグ、期間による多次元検索 - **📊 コンテキスト推奨** - ファイル関連性に基づくスマートな推奨 ## 🚀 クイックスタート ### 1. 依存関係のインストール ```bash npm install ``` ### 2. プロジェクトのビルド ```bash npm run build ``` ### 3. Claude Code の設定 Claude Code の設定ファイル（`~/.claude.json`）に MCP サーバー設定を追加： ```json { "mcpServers": { "conversation-logger": { "command": "node", "args": ["/path/to/ai-conversation-logger-mcp/dist/index.js"] } } } ``` ### 4. Claude Code の再起動 設定を適用するために Claude Code を再起動します。 ## 📚 API ツール ### 1. log_conversation - コアロギングツール 構造化された情報を含む AI とユーザーのやり取りを記録： ```typescript interface LogConversationParams { userRequest: string; // ユーザーの元のリクエスト + アップロードファイルの説明 aiTodoList: string[]; // AI の実行計画リスト（閲覧のみのタスクもリスト化） aiSummary: string; // AI の操作要約（3-5文） fileOperations?: string[]; // ファイル操作、形式："アクション ファイルパス - 説明" title?: string; // 会話タイトル（オプション） tags?: string[]; // タグ配列（オプション） project?: string; // プロジェクト名（オプション、自動検出） } ``` ### 2. search_conversations - 検索ツール 複数のフィルターで会話履歴を検索： ```typescript interface SearchParams { keywords?: string[]; // キーワード検索 filePattern?: string; // ファイル名パターン検索 days?: number; // 直近 N 日間 project?: string; // プロジェクトフィルター（デフォルト：現在） tags?: string[]; // タグフィルター limit?: number; // 結果数制限（デフォルト：10） } ``` ### 3. get_context_suggestions - コンテキスト推奨 現在の作業に基づいて関連する履歴コンテキストを取得： ```typescript interface ContextParams { currentInput: string; // 現在のユーザー入力 currentFiles?: string[]; // 現在関わっているファイル project?: string; // プロジェクトフィルター（オプション） } ``` ## 📁 ストレージ構造 ログはプロジェクトの `ai-logs/` ディレクトリに保存： ``` プロジェクトルート/ ├── ai-logs/ │ ├── 2025-08-07.md # 日次会話ログ │ ├── 2025-08-06.md │ └── config.json # プロジェクト設定 ├── src/ └── ... ``` ## 📝 ログ形式 各会話は以下の構造で記録： ```markdown ## [タイムスタンプ] タイトル #タグ ### 🗣️ ユーザーリクエスト [ユーザーの元のリクエスト] ### 📋 AI実行計画 - [x] 完了したタスク - [ ] 未完了のタスク ### 🤖 AI要約 [達成した内容の要約] ### 📂 ファイル操作要約 - **作成** `path/to/file` - 用途説明 - **変更** `path/to/file` - 変更内容 - **削除** `path/to/file` - 削除理由 ### 🏷️ タグ #モジュール #技術 #タイプ ``` ## 🎯 使用原則 ### ロギングのタイミング **すべての会話をログに記録**、以下を含む： - 新機能開発 - バグ修正（大小問わず） - コードリファクタリング - 設定変更 - コード説明と分析 - 技術的な Q&A - コードレビュー - プロジェクト関連のあらゆる対話 ### 重要なポイント 1. **AI 主導のコンテンツ** - AI がログする情報を決定 2. **完全なコンテキスト** - 将来の参照用にすべての関連詳細を含む 3. **「何を」重視、「どのように」ではない** - 技術的詳細より機能性を強調 4. **一貫した形式** - 標準化された Markdown 構造を維持 ## 🛠️ 開発 ### 開発モード ```bash npm run dev ``` ### テストの実行 ```bash npm test ``` ### コードチェック ```bash npm run lint npm run lint:fix ``` ### TypeScript チェック ```bash npm run type-check ``` ## 🔧 技術スタック - **TypeScript** - 型安全な開発 - **MCP SDK** - Model Context Protocol 実装 - **Node.js** - ランタイム環境 - **Jest** - テストフレームワーク ## 📄 ライセンス MIT ## 🤝 コントリビューション コントリビューションを歓迎します！お気軽に Pull Request を送信してください。 ## 📮 お問い合わせ 問題や提案がある場合は、GitHub で issue を開いてください。