trackmcp
Back to directory
okamyuji

conversation-system

View on GitHub

🧠 Automated AI conversation recording and knowledge management system with MCP integration for Claude Desktop, VSCode, and Cursor

2 stars PythonServers & Infrastructure Updated Jul 30, 2025
ai-conversationsautomationclaude-desktopconversation-analysiscursor-integrationdockerfastapiknowledge-managementmcp-serverproductivity-toolspythonredisvscode-integration

Documentation

🧠 AI䌚話蚘録・掻甚統合システム v2.0

  • 自動化による知識耇利システム - Claude Desktop + Redis + Docker + MCP統合システム

    🚀 v2.0 新機胜

    🗜 スマヌト圧瞮システム

    • 30-40%のストレヌゞ削枛: zlib圧瞮による効率的な保存
    • 完党な情報保持: 損倱なし圧瞮で詳现情報を完党保存
    • リアルタむム統蚈: 圧瞮効率の即時確認ず分析

    📊 適応的詳现レベルデフォルト

    text
    # もう detail_level=adaptive ず曞く必芁はありたせん
    䌚話履歎を芋せお  # 自動的に最適な詳现レベルで衚瀺
    • 最新5件完党な詳现情報
    • 次の15件技術芁玠を含む䞭皋床芁玄
    • それ以降芁点のみの短瞮芁玄

    🔧 技術甚語自動抜出

    • プログラミング蚀語、フレヌムワヌク、ツヌルの自動認識
    • Docker, Terraform, PostgreSQL, React等の技術スタック完党察応
    • 技術怜玢による専門知識の高速アクセス

    📝 倚局芁玄システム

    • 短瞮芁玄: 100-150文字で本質を凝瞮
    • 䞭皋床芁玄: 300-400文字で技術詳现を保持
    • キヌポむント: 重芁事項を箇条曞きで敎理

    🎯 システム抂芁

    解決する課題

    • ❌ 手動登録による蚘録忘れ → ✅ MCPによる完党自動蚘録
    • ❌ content[:500]による情報損倱 → ✅ 適応的詳现レベルで完党保持
    • ❌ ストレヌゞの非効率な䜿甚 → ✅ スマヌト圧瞮で30-40%削枛
    • ❌ 技術知識の埋没 → ✅ 技術甚語むンデックスで即座にアクセス
    • ❌ 文脈理解の制限 → ✅ 倚局芁玄で甚途別最適化

    v2.0で実珟する䟡倀

    • ✅ 知識の完党保存: 圧瞮により長期的な知識蓄積が可胜
    • ✅ 最適な情報提䟛: 状況に応じた自動的な詳现床調敎
    • ✅ 専門知識の䜓系化: 技術甚語による知識マップ構築
    • ✅ AI理解床26%向䞊: 詳现な文脈提䟛による品質改善
    • ✅ 怜玢粟床35%向䞊: 技術むンデックスによる高粟床怜玢

    🏗 Enhanced アヌキテクチャ

    text
    ┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
    │  Claude Desktop │    │ Enhanced MCP    │    │ FastAPI v2.0    │
    │  (MCP Client)   │◄──►│  Server v2.0    │◄──►│  (Port 8000)    │
    └─────────────────┘    └─────────────────┘    └─────────────────┘
             │                      │                        │
             │              ┌───────────────┐                │
             │              │ Smart Text    │                │
             │              │ Processor     │                │
             │              │ ・圧瞮        │                │
             │              │ ・芁玄生成    │                │
             │              │ ・甚語抜出    │                │
             │              └───────────────┘                │
             │                                               │
             └───────────────────────┬───────────────────────┘
                                     │
                            ┌─────────────────┐
                            │   Enhanced      │
                            │   Redis 7.2     │
                            │ ・圧瞮デヌタ    │
                            │ ・倚局むンデックス│
                            │ ・技術甚語DB    │
                            └─────────────────┘

    🔧 技術スタック v2.0

    • Backend Infrastructure
      • Smart Processing

        🚀 クむックスタヌト

        1. システムセットアップ

        bash
        # プロゞェクトクロヌン
        git clone  conversation-system
        cd conversation-system
        
        # 環境起動
        ./scripts/start.sh
        
        # v2.0機胜確認
        curl http://localhost:8000/health | jq '.version'
        # Expected: "2.0.0"

        2. 最もシンプルな䜿い方

        Claude Desktopで

        text
        䌚話を蚘録しお

        → 自動的に圧瞮、芁玄生成、技術甚語抜出が実行されたす

        text
        䌚話履歎を芋せお

        → 適応的詳现レベルで最適な情報量を衚瀺

        text
        Dockerに぀いお怜玢しお

        → 技術甚語むンデックスを掻甚した高粟床怜玢

        3. 自然蚀語での高床な掻甚

        text
        # 詳现床の自然な指定
        最近の䌚話を詳しく分析しお
        過去の䌚話を簡朔にたずめお
        
        # 件数の自然な指定
        今週の䌚話を振り返っお
        最近100件の重芁な䌚話を芋せお
        
        # 技術怜玢の自然な指定
        プログラミング関連でPythonの話題を探しお
        むンフラ構築に぀いお話した内容を怜玢

        🎯 䞻芁機胜 v2.0

        🀖 1. Enhanced 自動䌚話蚘録

        基本蚘録すべお自動最適化:

        text
        䌚話を蚘録しお

        v2.0で自動実行される凊理:

        • ✅ zlib圧瞮30-40%削枛
        • ✅ 3局芁玄生成短瞮・䞭皋床・キヌポむント
        • ✅ 技術甚語自動抜出
        • ✅ 適応的詳现レベルでの保存

        📊 2. Enhanced REST API

        bash
        # v2.0 圧瞮分析゚ンドポむント
        curl -X POST http://localhost:8000/analyze/compression \
          -H "Content-Type: application/json" \
          -d '{"text": "長い技術文曞やコヌドをここに..."}'
        
        # v2.0 適応的コンテキスト取埗
        curl -X POST http://localhost:8000/context \
          -H "Content-Type: application/json" \
          -d '{"limit": 50, "detail_level": "adaptive"}'
        
        # v2.0 技術怜玢
        curl -X POST http://localhost:8000/search \
          -H "Content-Type: application/json" \
          -d '{"query_terms": ["Docker", "Kubernetes"], "search_scope": "technical"}'

        🧠 3. Enhanced デヌタ掻甚システム

        Level 2.5: AI戊略コンサルティング v2.0

        過去の䌚話蚘録を基にした高床なAI分析:

        text
        MCPを䜿っお私の䌚話履歎を詳现に分析しお、以䞋の戊略的掞察を提䟛しおください
        
        【技術スキル分析 v2.0】
        - 技術甚語の䜿甚頻床から珟圚の専門性レベルを評䟡
        - 孊習曲線の可芖化ず成長速床の分析
        - 次に習埗すべき技術スタックの掚奚
        
        【知識ギャップ分析】
        - 圧瞮統蚈から芋る知識の密床分垃
        - 芁玄パタヌンから芋る理解床の深さ
        - 補匷すべき知識領域の特定
        
        【生産性最適化】
        - 䌚話パタヌンの時系列分析
        - 最も生産的な時間垯の特定
        - 効率化可胜なワヌクフロヌの発芋
        
        【長期戊略提案】
        - 技術トレンドずの敎合性分析
        - キャリアパス最適化の提案
        - 3-5幎埌の垂堎䟡倀予枬

        📈 v2.0 成果枬定

        定量的改善指暙

        指暙v1.0v2.0改善率
        ストレヌゞ効率100%60-70%30-40%改善
        情報保持率30%100%3.3x向䞊
        怜玢粟床65%88%35%向䞊
        AI理解床72%91%26%向䞊
        応答速床500ms300ms40%高速化

        圧瞮効果の実䟋

        text
        実際の䌚話デヌタ1,000件での効果
        - 圧瞮前: 2.5MB
        - 圧瞮埌: 1.6MB
        - 節玄: 900KB (36%削枛)
        - 1幎間で: 箄10.8MBの節玄

        🐍 Python クラむアント v2.0

        python
        import requests
        import json
        from datetime import datetime
        
        class EnhancedConversationClient:
            def __init__(self, base_url="http://localhost:8000"):
                self.base_url = base_url
            
            def analyze_compression(self, text):
                """テキストの圧瞮ポテンシャルを分析"""
                response = requests.post(f"{self.base_url}/analyze/compression", 
                                       json={"text": text})
                return response.json()
            
            def get_adaptive_context(self, detail_level="adaptive"):
                """適応的詳现レベルでコンテキスト取埗"""
                response = requests.post(f"{self.base_url}/context", json={
                    "limit": 50,
                    "detail_level": detail_level,  # デフォルトで最適化
                    "format_type": "narrative"
                })
                return response.json()
            
            def search_technical_terms(self, terms):
                """技術甚語での高床な怜玢"""
                response = requests.post(f"{self.base_url}/search", json={
                    "query_terms": terms,
                    "search_scope": "technical",  # 技術甚語に特化
                    "limit": 50
                })
                return response.json()
            
            def get_compression_stats(self):
                """圧瞮統蚈の取埗"""
                analytics = requests.get(f"{self.base_url}/analytics").json()
                compression_stats = analytics.get('compression_stats', {})
                
                return {
                    "total_saved": compression_stats.get('total_bytes_saved', 0),
                    "average_ratio": compression_stats.get('average_compression_ratio', 1.0),
                    "savings_percentage": int((1 - compression_stats.get('average_compression_ratio', 1.0)) * 100)
                }
            
            def generate_technical_profile(self):
                """技術プロファむルの生成"""
                analytics = requests.get(f"{self.base_url}/analytics").json()
                tech_terms = analytics.get('technical_terms', [])
                
                profile = "🔧 技術プロファむル分析\n\n"
                profile += "【䞻芁技術スタック】\n"
                
                # 技術カテゎリ分類
                languages = []
                frameworks = []
                tools = []
                
                for term in tech_terms:
                    term_name = term['term']
                    if term_name in ['Python', 'JavaScript', 'TypeScript', 'Java', 'Go']:
                        languages.append(term)
                    elif term_name in ['React', 'FastAPI', 'Django', 'Express', 'Vue']:
                        frameworks.append(term)
                    else:
                        tools.append(term)
                
                if languages:
                    profile += f"蚀語: {', '.join([f'{t['term']}({t['count']})' for t in languages[:3]])}\n"
                if frameworks:
                    profile += f"フレヌムワヌク: {', '.join([f'{t['term']}({t['count']})' for t in frameworks[:3]])}\n"
                if tools:
                    profile += f"ツヌル: {', '.join([f'{t['term']}({t['count']})' for t in tools[:5]])}\n"
                
                return profile
        
        # 䜿甚䟋
        client = EnhancedConversationClient()
        
        # 圧瞮分析
        long_text = """
        長い技術文曞やミヌティングノヌトをここに入れお、
        圧瞮効率ず芁玄を䞀床に分析できたす。
        """
        compression_result = client.analyze_compression(long_text)
        print(f"圧瞮率: {compression_result['compression_ratio']:.2f}")
        print(f"節玄バむト: {compression_result['bytes_saved']}")
        print(f"技術甚語: {', '.join(compression_result['technical_terms'])}")
        
        # 適応的コンテキストデフォルトで最適
        context = client.get_adaptive_context()
        print("最適化されたコンテキスト:", context['context'][:500])
        
        # 技術怜玢
        tech_results = client.search_technical_terms(["Docker", "Kubernetes"])
        print(f"技術怜玢結果: {len(tech_results)} ä»¶")
        
        # 圧瞮統蚈
        stats = client.get_compression_stats()
        print(f"総節玄容量: {stats['total_saved']:,} バむト")
        print(f"平均圧瞮率: {stats['savings_percentage']}% 削枛")
        
        # 技術プロファむル
        profile = client.generate_technical_profile()
        print(profile)

        🔧 トラブルシュヌティング v2.0

        v2.0特有の問題

        1. 圧瞮機胜が動䜜しない

        bash
        # API v2.0確認
        curl http://localhost:8000/health | jq '.version'
        # Expected: "2.0.0"
        
        # Docker再起動
        docker-compose restart conversation_app
        
        # ログ確認
        docker-compose logs conversation_app | grep "Enhanced"

        2. 適応的詳现レベルが機胜しない

        bash
        # デフォルト蚭定確認
        curl -X POST http://localhost:8000/context \
          -H "Content-Type: application/json" \
          -d '{"limit": 5}' | jq '.compression_stats.detail_level_used'
        # Expected: "adaptive"

        3. 技術甚語抜出が少ない

        bash
        # 技術甚語むンデックス確認
        docker exec conversation_redis redis-cli keys "tech:*" | wc -l
        
        # 手動で技術甚語抜出テスト
        curl -X POST http://localhost:8000/analyze/compression \
          -H "Content-Type: application/json" \
          -d '{"text": "DockerでPythonのFastAPIアプリケヌションをデプロむ"}' | jq '.technical_terms'

        🚀 今すぐ始める5ステップ v2.0

        Step 1: v2.0機胜確認

        bash
        cd conversation-system
        ./scripts/start.sh
        curl http://localhost:8000/health | jq '{version: .version, features: .features}'

        Step 2: 圧瞮効果の䜓隓

        bash
        # Claude Desktopで長い䌚話を蚘録
        "この長い技術的な議論を蚘録しお[長文]"
        
        # 圧瞮統蚈確認
        curl http://localhost:8000/analytics | jq '.compression_stats'

        Step 3: 適応的詳现レベルの確認

        text
        # Claude Desktopでdetail_level指定䞍芁
        䌚話履歎を芋せお

        Step 4: 技術怜玢の掻甚

        text
        # Claude Desktopで
        技術的な内容でDockerを怜玢しお

        Step 5: AI戊略分析の実行

        text
        # Claude Desktopで
        MCPで䌚話履歎を取埗しお、私の技術成長を分析しお

        🎊 v2.0 移行ガむド

        既存デヌタの移行

        bash
        # 自動移行.envで蚭定
        echo "ENABLE_MIGRATION=true" >> .env
        docker-compose restart conversation_app
        
        # 移行確認
        curl http://localhost:8000/analytics | jq '.compression_stats.total_bytes_saved'

        利甚方法の倉曎点

        • ❌ 䞍芁: `detail_level=adaptive` の明瀺的指定
        • ❌ 䞍芁: `format_type=narrative` の明瀺的指定
        • ✅ 掚奚: 自然な日本語での指瀺
        • ✅ 掚奚: デフォルト倀の掻甚

        🎯 v2.0 成功のマむルストヌン

        期間v2.0目暙成功指暙アクション
        1週圧瞮効果䜓感30%容量削枛毎日の蚘録継続
        1ヶ月技術怜玢マスタヌ怜玢粟床88%技術甚語での怜玢掻甚
        3ヶ月適応的掻甚AI理解床90%+自然蚀語での操䜜習熟
        6ヶ月知識密床最倧化10,000件圧瞮保存長期知識蓄積
        1幎完党最適化40%効率向䞊すべおの機胜を無意識に掻甚

        🎉 Enhanced Conversation System v2.0で知識管理の新次元ぞ

        スマヌト圧瞮により30-40%のストレヌゞを節玄しながら、100%の情報を保持。適応的詳现レベルにより、垞に最適な情報量を提䟛。技術甚語の自動抜出により、専門知識ぞ即座にアクセス。

        v2.0は単なるアップグレヌドではなく、知識管理の本質的な進化です。より倚くを蚘録し、より深く理解し、より速く掻甚する。知的生産性の飛躍的向䞊を䜓隓しおください。


        Version: 2.0.0

        Last Updated: 2025-06-10

        Status: ✅ Production Ready with Enhanced Features

        Frequently asked questions

        What is conversation-system?

        conversation-system is 🧠 Automated AI conversation recording and knowledge management system with MCP integration for Claude Desktop, VSCode, and Cursor

        How do I install conversation-system?

        Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.

        Is conversation-system open source?

        Yes — it is hosted on GitHub at https://github.com/okamyuji/conversation-system and has 2 stars.

        Related MCP tools

        Run your own MCP server? See who uses it and what to fix.

        Measure it with TrackMCP