Skip to main content
Glama

Claude Conversation Logger

🤖 Claude Conversation Logger v3.1.0

🎯 Intelligent Conversation Management Platform - Advanced logging system with 4 Claude Code compatible agents, deep semantic analysis, automatic documentation, and 70% token optimization.


4 CLAUDE CODE AGENTS SYSTEM

🧠 The Core Functionality

Claude Conversation Logger includes an optimized system of 4 Claude Code compatible agents that provides intelligent analysis, automatic documentation, and pattern discovery in technical conversations.

🎭 The 4 Claude Code Agents
AgentPrimary FunctionUse Cases
🎭 conversation-orchestrator-agentMain coordinator making intelligent decisionsMulti-dimensional complex analysis, agent delegation
🧠 semantic-analyzer-agentDeep semantic content analysisTopics, entities, technical pattern extraction
🔍 pattern-discovery-agentHistorical pattern discoveryIdentify recurring problems and solutions
📝 auto-documentation-agentAutomatic documentation generationCreate structured problem-solution guides
🚀 Intelligent Capabilities
# 🔍 Intelligent semantic search "authentication error" → Finds all authentication-related conversations # 📝 Contextual automatic documentation Completed session → Automatically generates structured documentation # 🔗 Intelligent relationship mapping Current problem → Finds 5 similar conversations with solutions # 📊 Predictive pattern analysis "API timeout" → Identifies 15 similar cases + most effective solutions # 🌍 Multi-language support Mixed ES/EN conversation → Detects patterns in both languages
⚡ Key Benefits
  • Token Optimization: 70% reduction vs manual analysis
  • Instant Analysis: < 3 seconds for complete multi-agent analysis
  • High Accuracy: 95%+ in pattern and state detection
  • Multi-language Support: Spanish/English with extensible framework
  • Intelligent Cache: 85%+ hit rate for fast responses
  • Self-learning: Continuous improvement with usage

🚀 QUICK START - 3 STEPS

Step 1: Launch the System

# Clone and start git clone https://github.com/LucianoRicardo737/claude-conversation-logger.git cd claude-conversation-logger # Launch with Docker (includes agents) docker compose up -d --build # Verify it's working curl http://localhost:3003/health

Step 2: Configure Claude Code

# Copy MCP configuration cp examples/claude-settings.json ~/.claude/settings.json # Copy logging hook cp examples/api-logger.py ~/.claude/hooks/ chmod +x ~/.claude/hooks/api-logger.py

Step 3: Use the Agents

# In Claude Code - search similar conversations search_conversations({ query: "payment integration error", days: 30, includePatterns: true }) # Intelligent analysis of current conversation analyze_conversation_intelligence({ session_id: "current_session", includeRelationships: true }) # Automatic documentation auto_document_session({ session_id: "completed_troubleshooting" })

🎉 System ready! Agents are automatically analyzing all your conversations.


🔌 CLAUDE CODE INTEGRATION (MCP)

5 Native Agent Tools

The system provides 5 native MCP tools for Claude Code:

MCP ToolResponsible AgentFunctionality
search_conversationssemantic-analyzer-agentIntelligent search with semantic analysis
get_recent_conversationsconversation-orchestrator-agentRecent activity with intelligent context
analyze_conversation_patternspattern-discovery-agentHistorical pattern analysis
export_conversationauto-documentation-agentExport with automatic documentation
analyze_conversation_intelligenceconversation-orchestrator-agentComplete multi-dimensional analysis

Claude Code Configuration

~/.claude/settings.json

{ "mcp": { "mcpServers": { "conversation-logger": { "command": "node", "args": ["src/mcp-server.js"], "cwd": "/path/to/claude-conversation-logger", "env": { "API_URL": "http://localhost:3003", "API_KEY": "claude_api_secret_2024_change_me" } } } }, "hooks": { "UserPromptSubmit": [{"hooks": [{"type": "command", "command": "python3 ~/.claude/hooks/api-logger.py"}]}], "Stop": [{"hooks": [{"type": "command", "command": "python3 ~/.claude/hooks/api-logger.py"}]}] } }

Claude Code Usage Examples

// Search for similar problems with semantic analysis search_conversations({ query: "React hydration mismatch SSR", days: 60, includePatterns: true, minConfidence: 0.75 }) // Result: Related conversations + patterns + proven solutions
📊 Pattern Analysis
// Identify recurring problems in project analyze_conversation_patterns({ days: 30, project: "my-api-service", minFrequency: 3 }) // Result: Top issues + success rates + recommendations
📝 Automatic Documentation
// Generate documentation from completed session export_conversation({ session_id: "current_session", format: "markdown", includeCodeExamples: true }) // Result: Structured markdown with problem + solution + code
🧠 Complete Multi-Agent Analysis
// Deep analysis with all agents analyze_conversation_intelligence({ session_id: "complex_debugging_session", includeSemanticAnalysis: true, includeRelationships: true, generateInsights: true }) // Result: Complete analysis + insights + recommendations

🛠️ AGENT REST API

5 Claude Code Endpoints

Analysis and Orchestration
# Complete multi-agent analysis POST /api/agents/orchestrator Content-Type: application/json X-API-Key: claude_api_secret_2024_change_me { "type": "deep_analysis", "data": {"session_id": "sess_123"}, "options": { "includeSemanticAnalysis": true, "generateInsights": true, "maxTokenBudget": 150 } }
Pattern Discovery
# Find recurring patterns GET /api/agents/patterns?days=30&minFrequency=3&project=api-service # Response: Identified patterns + frequency + solutions
Relationship Mapping
# Search for related conversations GET /api/agents/relationships/sess_123?minConfidence=0.7&maxResults=10 # Response: Similar conversations + relationship type + confidence
Automatic Documentation
# Generate intelligent documentation POST /api/agents/document { "session_id": "sess_123", "options": { "autoDetectPatterns": true, "includeCodeExamples": true } }

Main API Endpoints

Conversation Management
# Log conversation (used by hooks) POST /api/conversations # Search with semantic analysis GET /api/conversations/search?q=authentication&days=30&semantic=true # Export with automatic documentation GET /api/conversations/{session_id}/export?format=markdown&enhanced=true
Analytics and Metrics
# Project statistics GET /api/projects/stats # Agent metrics GET /api/agents/metrics # System health GET /health

🏗️ TECHNICAL ARCHITECTURE

Agent Architecture

System Components

ComponentTechnologyPortFunction
🤖 Agent SystemNode.js 18+-Intelligent conversation analysis
🔌 MCP ServerMCP SDKstdioNative Claude Code integration
🌐 REST APIExpress.js3003Agent and management endpoints
💾 MongoDB7.0270178 specialized collections
⚡ Redis7.06379Intelligent agent cache
🐳 DockerCompose-Monolithic orchestration

Data Flow


⚙️ AGENT CONFIGURATION

42 Configuration Parameters

The agent system is fully configurable via Docker Compose:

🌍 Language Configuration
# docker-compose.yml environment: # Primary languages AGENT_PRIMARY_LANGUAGE: "es" AGENT_SECONDARY_LANGUAGE: "en" AGENT_MIXED_LANGUAGE_MODE: "true" # Keywords in Spanish + English (JSON arrays) AGENT_WRITE_KEYWORDS: '["documentar","guardar","document","save","create doc"]' AGENT_READ_KEYWORDS: '["buscar","encontrar","similar","search","find","lookup"]' AGENT_RESOLUTION_KEYWORDS: '["resuelto","funcionando","resolved","fixed","working"]' AGENT_PROBLEM_KEYWORDS: '["error","problema","falla","bug","issue","crash"]'
🎯 Performance Parameters
environment: # Detection thresholds AGENT_SIMILARITY_THRESHOLD: "0.75" AGENT_CONFIDENCE_THRESHOLD: "0.80" AGENT_MIN_PATTERN_FREQUENCY: "3" # Token optimization AGENT_MAX_TOKEN_BUDGET: "100" AGENT_CACHE_TTL_SECONDS: "300" # Feature flags AGENT_ENABLE_SEMANTIC_ANALYSIS: "true" AGENT_ENABLE_AUTO_DOCUMENTATION: "true" AGENT_ENABLE_RELATIONSHIP_MAPPING: "true" AGENT_ENABLE_PATTERN_PREDICTION: "true"

8 Agent MongoDB Collections

Main Collections
// conversations - Base conversations { _id: ObjectId("..."), session_id: "sess_123", project: "api-service", user_message: "Payment integration failing", ai_response: "Let me help debug the payment flow...", timestamp: ISODate("2025-08-25T10:00:00Z"), metadata: { resolved: true, complexity: "intermediate", topics: ["payment", "integration", "debugging"] } } // conversation_patterns - Agent-detected patterns { pattern_id: "api_timeout_pattern", title: "API Timeout Issues", frequency: 23, confidence: 0.87, common_solution: "Increase timeout + add retry logic", affected_projects: ["api-service", "payment-gateway"] } // conversation_relationships - Session connections { source_session: "sess_123", target_session: "sess_456", relationship_type: "similar_problem", confidence_score: 0.89, detected_by: "semantic-analyzer-agent" } // conversation_insights - Generated insights { insight_type: "recommendation", priority: "high", title: "Frequent Database Connection Issues", recommendations: ["Add connection pooling", "Implement retry logic"] }

🔧 INSTALLATION & DEPLOYMENT

Requirements

  • Docker 20.0+ with Docker Compose
  • Python 3.8+ (for hooks)
  • Claude Code installed and configured
  • 4GB+ available RAM

Complete Installation

1. Clone and Setup
# Clone repository git clone https://github.com/LucianoRicardo737/claude-conversation-logger.git cd claude-conversation-logger # Verify structure ls -la # Should show: src/, config/, examples/, docker-compose.yml
2. Docker Deployment
# Build and start complete system docker compose up -d --build # Verify services (should show 1 running container) docker compose ps # Verify system health curl http://localhost:3003/health # Expected: {"status":"healthy","services":{"api":"ok","mongodb":"ok","redis":"ok"}}
3. Claude Code Configuration
# Create hooks directory if it doesn't exist mkdir -p ~/.claude/hooks # Copy logging hook cp examples/api-logger.py ~/.claude/hooks/ chmod +x ~/.claude/hooks/api-logger.py # Configure Claude Code settings cp examples/claude-settings.json ~/.claude/settings.json # Or merge with existing settings
4. System Verification
# API test curl -H "X-API-Key: claude_api_secret_2024_change_me" \ http://localhost:3003/api/conversations | jq . # Agent test curl -H "X-API-Key: claude_api_secret_2024_change_me" \ http://localhost:3003/api/agents/health # Hook test (simulate) python3 ~/.claude/hooks/api-logger.py

Environment Variables

Base Configuration
# Required MONGODB_URI=mongodb://localhost:27017/conversations REDIS_URL=redis://localhost:6379 API_KEY=your_secure_api_key_here NODE_ENV=production # Optional performance API_MAX_CONNECTIONS=100 MONGODB_POOL_SIZE=20 REDIS_MESSAGE_LIMIT=10000
Agent Configuration (42 variables)
# Languages and keywords AGENT_PRIMARY_LANGUAGE=es AGENT_MIXED_LANGUAGE_MODE=true AGENT_WRITE_KEYWORDS='["documentar","document","save"]' # Performance and thresholds AGENT_MAX_TOKEN_BUDGET=100 AGENT_SIMILARITY_THRESHOLD=0.75 AGENT_CACHE_TTL_SECONDS=300 # Feature flags AGENT_ENABLE_SEMANTIC_ANALYSIS=true AGENT_ENABLE_AUTO_DOCUMENTATION=true

🎯 PRACTICAL USE CASES

🔍 Scenario 1: Recurring Debugging

// Problem: "Payments fail sporadically" // In Claude Code, use MCP tool: search_conversations({ query: "payment failed timeout integration", days: 90, includePatterns: true }) // semantic-analyzer-agent + pattern-discovery-agent return: // - 8 similar conversations found // - Pattern identified: "Gateway timeout after 30s" (frequency: 23 times) // - Proven solution: "Increase timeout to 60s + add retry" (success: 94%) // - Related conversations: sess_456, sess_789, sess_012

📝 Scenario 2: Automatic Documentation

// After solving a complex bug // auto-documentation-agent generates contextual documentation: export_conversation({ session_id: "debugging_session_456", format: "markdown", includeCodeExamples: true, autoDetectPatterns: true }) // System automatically generates: /* # Solution: Payment Gateway Timeout Issues ## Problem Identified - Gateway timeout after 30 seconds - Affects payments during peak hours - Error: "ETIMEDOUT" in logs ## Investigation Performed 1. Nginx logs analysis 2. Timeout configuration review 3. Network latency monitoring ## Solution Implemented ```javascript const paymentConfig = { timeout: 60000, // Increased from 30s to 60s retries: 3, // Added retry logic backoff: 'exponential' };

Verification

  • ✅ Tests passed: payment-integration.test.js
  • ✅ Timeout reduced from 23 errors/day to 0
  • ✅ Success rate: 99.2%

Tags

#payment #timeout #gateway #production-fix */

### **📊 Scenario 3: Project Analysis** ```javascript // Analyze project health with pattern-discovery-agent analyze_conversation_patterns({ project: "e-commerce-api", days: 30, minFrequency: 3, includeSuccessRates: true }) // System automatically identifies: { "top_issues": [ { "pattern": "Database connection timeouts", "frequency": 18, "success_rate": 0.89, "avg_resolution_time": "2.3 hours", "recommended_action": "Implement connection pooling" }, { "pattern": "Redis cache misses", "frequency": 12, "success_rate": 0.92, "avg_resolution_time": "45 minutes", "recommended_action": "Review cache invalidation strategy" } ], "trending_topics": ["authentication", "api-rate-limiting", "database-performance"], "recommendation": "Focus on database optimization - 60% of issues stem from DB layer" }
// Working on a new problem, search for similar context // semantic-analyzer-agent finds intelligent connections: search_conversations({ query: "React component not rendering after state update", days: 60, includeRelationships: true, minConfidence: 0.7 }) // Result with relational analysis: { "direct_matches": [ { "session_id": "sess_789", "similarity": 0.94, "relationship_type": "identical_problem", "solution_confidence": 0.96, "quick_solution": "Add useEffect dependency array" } ], "related_conversations": [ { "session_id": "sess_234", "similarity": 0.78, "relationship_type": "similar_context", "topic_overlap": ["React", "state management", "useEffect"] } ], "patterns_detected": { "common_cause": "Missing useEffect dependencies", "frequency": 15, "success_rate": 0.93 } }

🧠 Scenario 5: Complete Multi-Agent Analysis

// For complex conversations, activate all agents: analyze_conversation_intelligence({ session_id: "complex_debugging_session", includeSemanticAnalysis: true, includeRelationships: true, generateInsights: true, maxTokenBudget: 200 }) // conversation-orchestrator-agent coordinates all agents: { "semantic_analysis": { "topics": ["microservices", "docker", "kubernetes", "monitoring"], "entities": ["Prometheus", "Grafana", "Helm charts"], "complexity": "advanced", "resolution_confidence": 0.91 }, "session_state": { "status": "completed", "quality_score": 0.87, "documentation_ready": true }, "relationships": [ { "session_id": "sess_345", "similarity": 0.82, "type": "follow_up" } ], "patterns": { "recurring_issue": "Kubernetes resource limits", "frequency": 8, "trend": "increasing" }, "insights": [ { "type": "recommendation", "priority": "high", "description": "Consider implementing HPA for dynamic scaling", "confidence": 0.85 } ] }

📖 Complete Agent Documentation

For advanced usage and detailed configuration, consult the agent documentation:


📚 PROJECT STRUCTURE

claude-conversation-logger/ ├── 📄 README.md # Main documentation ├── 🚀 QUICK_START.md # Quick setup guide ├── 🐳 docker-compose.yml # Complete orchestration ├── 📦 package.json # Dependencies and scripts ├── 🔧 config/ # Service configurations │ ├── supervisord.conf # Process management │ ├── mongodb.conf # MongoDB configuration │ └── redis.conf # Redis configuration ├── 🔌 src/ # Source code │ ├── server.js # Main API server │ ├── mcp-server.js # MCP server for Claude Code │ │ │ ├── 💾 database/ # Data layer │ │ ├── mongodb-agent-extension.js # MongoDB + agent collections │ │ ├── redis.js # Intelligent cache │ │ └── agent-schemas.js # Agent schemas │ │ │ ├── 🔧 services/ # Business services │ │ ├── conversationService.js # Conversation management │ │ ├── searchService.js # Semantic search │ │ └── exportService.js # Export with agents │ │ │ └── 🛠️ utils/ # Utilities │ └── recovery-manager.js # Data recovery ├── 🤖 .claude/ # Claude Code Integration │ ├── agents/ # Agent definitions (markdown format) │ │ ├── conversation-orchestrator-agent.md # Main orchestrator │ │ ├── semantic-analyzer-agent.md # Semantic analysis │ │ ├── pattern-discovery-agent.md # Pattern detection │ │ └── auto-documentation-agent.md # Documentation generation │ └── context/ # Knowledge base and troubleshooting ├── 💡 examples/ # Examples and configuration │ ├── claude-settings.json # Complete Claude Code config │ ├── api-logger.py # Logging hook │ └── mcp-usage-examples.md # MCP usage examples └── 🧪 tests/ # Test suite ├── agents.test.js # Agent tests ├── api.test.js # API tests └── integration.test.js # Integration tests

📈 METRICS & PERFORMANCE

🎯 Agent Metrics

  • Semantic Analysis: 95%+ accuracy in topic detection
  • State Detection: 90%+ accuracy in completed/active
  • Relationship Mapping: 85%+ accuracy in similarity
  • Token Optimization: 70% reduction vs manual analysis
  • Response Time: < 3 seconds complete analysis

⚡ System Performance

  • Startup Time: < 30 seconds complete container
  • API Response: < 100ms average
  • Cache Hit Rate: 85%+ on frequent queries
  • Memory Usage: ~768MB typical
  • Concurrent Users: 100+ supported

📊 Codebase Statistics

  • Lines of Code: 3,800+ (optimized agent system)
  • JavaScript Files: 15+ core files
  • Agent Files: 4 Claude Code compatible files
  • API Endpoints: 28+ endpoints (23 core + 5 agent tools)
  • MCP Tools: 5 native tools
  • MongoDB Collections: 8 specialized collections

🛡️ SECURITY & MAINTENANCE

🔐 Security

  • API Key Authentication: Required for all endpoints
  • Helmet.js Security: Security headers and protections
  • Rate Limiting: 200 requests/15min in production
  • Configurable CORS: Cross-origin policies configurable
  • Data Encryption: Data encrypted at rest and in transit

🔧 Troubleshooting

System won't start
# Check logs docker compose logs -f # Check resources docker stats
Agents not responding
# Agent health check curl http://localhost:3003/api/agents/health # Check configuration curl http://localhost:3003/api/agents/config
Hook not working
# Manual hook test python3 ~/.claude/hooks/api-logger.py # Check permissions chmod +x ~/.claude/hooks/api-logger.py # Test API connectivity curl -X POST http://localhost:3003/api/conversations \ -H "X-API-Key: claude_api_secret_2024_change_me" \ -H "Content-Type: application/json" \ -d '{"test": true}'

📞 SUPPORT & CONTRIBUTION

🆘 Get Help

  • 📖 Technical Documentation: See Claude Code Agents
  • 🐛 Report Bugs: GitHub Issues
  • 💡 Request Features: GitHub Discussions

🤝 Contribute

# Fork and clone git clone https://github.com/your-username/claude-conversation-logger.git # Create feature branch git checkout -b feature/agent-improvements # Develop and test npm test npm run test:agents # Submit pull request git push origin feature/agent-improvements

🧪 Local Development

# Install dependencies npm install # Configure development environment cp examples/claude-settings.json ~/.claude/settings.json # Start in development mode npm run dev # Run agent tests npm run test:agents

📄 LICENSE & ATTRIBUTION

MIT License - See LICENSE for details.

Author: Luciano Emanuel Ricardo
Version: 3.1.0 - Claude Code Compatible Agent System
Repository: https://github.com/LucianoRicardo737/claude-conversation-logger


🎉 EXECUTIVE SUMMARY

4 Claude Code Compatible Agents - Optimized multi-dimensional intelligent analysis
Native Claude Code Integration - 5 ready-to-use MCP tools
70% Token Optimization - Maximum efficiency in analysis
Multi-language Support - Spanish/English with extensible framework
Deep Semantic Analysis - True understanding of technical content
Automatic Documentation - Contextual guide generation
Pattern Discovery - Proactive identification of recurring problems
Relationship Mapping - Intelligent conversation connections
Intelligent Cache - 85%+ hit rate for instant responses
Complete REST API - 28+ endpoints including Claude Code agent tools
Docker Deployment - Production-ready monolithic system
42 Configurable Parameters - Complete customization via Docker Compose

🚀 Ready for immediate deployment with intelligent agent system!

-
security - not tested
A
license - permissive license
-
quality - not tested

local-only server

The server can only run on the client's local machine because it depends on local resources.

Enables intelligent conversation management with 4 AI agents that provide semantic analysis, pattern discovery, automatic documentation, and relationship mapping. Logs and analyzes Claude conversations with 70% token optimization and multi-language support.

  1. ⭐ 4 CLAUDE CODE AGENTS SYSTEM
    1. 🧠 The Core Functionality
  2. 🚀 QUICK START - 3 STEPS
    1. Step 1: Launch the System
    2. Step 2: Configure Claude Code
    3. Step 3: Use the Agents
  3. 🔌 CLAUDE CODE INTEGRATION (MCP)
    1. 5 Native Agent Tools
    2. Claude Code Configuration
    3. Claude Code Usage Examples
  4. 🛠️ AGENT REST API
    1. 5 Claude Code Endpoints
    2. Main API Endpoints
  5. 🏗️ TECHNICAL ARCHITECTURE
    1. Agent Architecture
    2. System Components
    3. Data Flow
  6. ⚙️ AGENT CONFIGURATION
    1. 42 Configuration Parameters
    2. 8 Agent MongoDB Collections
  7. 🔧 INSTALLATION & DEPLOYMENT
    1. Requirements
    2. Complete Installation
    3. Environment Variables
  8. 🎯 PRACTICAL USE CASES
    1. 🔍 Scenario 1: Recurring Debugging
    2. 📝 Scenario 2: Automatic Documentation
  9. Verification
    1. Tags
      1. 🔗 Scenario 4: Intelligent Context Search
      2. 🧠 Scenario 5: Complete Multi-Agent Analysis
      3. 📖 Complete Agent Documentation
    2. 📚 PROJECT STRUCTURE
      1. 📈 METRICS & PERFORMANCE
        1. 🎯 Agent Metrics
        2. ⚡ System Performance
        3. 📊 Codebase Statistics
      2. 🛡️ SECURITY & MAINTENANCE
        1. 🔐 Security
        2. 🔧 Troubleshooting
      3. 📞 SUPPORT & CONTRIBUTION
        1. 🆘 Get Help
        2. 🤝 Contribute
        3. 🧪 Local Development
      4. 📄 LICENSE & ATTRIBUTION
        1. 🎉 EXECUTIVE SUMMARY

          Related MCP Servers

          • -
            security
            F
            license
            -
            quality
            A comprehensive suite of Model Context Protocol servers designed to extend AI agent Claude's capabilities with integrations for knowledge management, reasoning, advanced search, news access, and workspace tools.
            Last updated -
            5
            • Apple
          • A
            security
            A
            license
            A
            quality
            Provides intelligent transcript processing capabilities for Claude, featuring natural formatting, contextual repair, and smart summarization powered by Deep Thinking LLMs.
            Last updated -
            4
            16
            MIT License
          • -
            security
            F
            license
            -
            quality
            Enables users to analyze, manage, and optimize digital advertising campaigns through natural language conversations in Claude, offering performance insights, interactive visualizations, and campaign management for platforms like Amazon Ads.
            Last updated -
            4
            • Apple
          • -
            security
            A
            license
            -
            quality
            A tool that connects Google Ads with Claude AI, allowing users to analyze advertising data through natural language conversations and access campaign information, performance metrics, keyword analytics, and ad management.
            Last updated -
            238
            MIT License
            • Apple

          View all related MCP servers

          MCP directory API

          We provide all the information about MCP servers via our MCP API.

          curl -X GET 'https://glama.ai/api/mcp/v1/servers/LucianoRicardo737/claude-conversation-logger'

          If you have feedback or need assistance with the MCP directory API, please join our Discord server