Chat Analysis

🚀 MCP 聊天分析服務器

MCP 聊天分析服務器基於模型上下文協議（MCP）構建，藉助向量嵌入和知識圖譜技術，實現對聊天對話的語義分析。它提供了一系列工具，可用於分析聊天數據、執行語義搜索、提取概念以及剖析對話模式。

🚀 快速開始

# 安裝包
pip install mcp-chat-analysis-server

# 設置配置
cp config.example.yml config.yml
# 使用config.yml編輯數據庫設置

# 運行服務器
python -m mcp_chat_analysis.server

✨ 主要特性

• 🔍 語義搜索：利用向量相似性查找相關消息和對話。
• 🕸️ 知識圖譜：可導航消息、概念和主題之間的關係。
• 📊 對話分析：分析模式、指標和對話動態。
• 🔄 靈活導入：支持多種聊天導出格式。
• 🚀 MCP 集成：能與Claude和其他兼容MCP的系統輕鬆集成。

📦 安裝指南

安裝依賴

• Python 3.8+
• Neo4j 數據庫用於知識圖譜存儲
• Qdrant 向量數據庫用於語義搜索
• sentence-transformers 用於嵌入

安裝步驟

1. 安裝包：

pip install mcp-chat-analysis-server

2. 設置數據庫：

# 使用 Docker（推薦）
docker compose up -d

3. 配置服務器：

cp .env.example .env
# 使用.env編輯你的設置

💻 使用示例

基礎用法

import_conversations

導入並分析聊天對話

{
    "source_path": "/path/to/export.zip",
    "format": "openai_native"  # 或 html、markdown、json
}

semantic_search

通過語義相似性搜索對話

{
    "query": "機器學習應用",
    "limit": 10,
    "min_score": 0.7
}

analyze_metrics

分析對話指標

{
    "conversation_id": "conv-123",
    "metrics": [
        "message_frequency",
        "response_times",
        "topic_diversity"
    ]
}

extract_concepts

提取並分析概念

{
    "conversation_id": "conv-123",
    "min_relevance": 0.5,
    "max_concepts": 10
}

高級用法

MCP 集成

添加到你的 claude_desktop_config.json：

{
    "mcpServers": {
        "chat-analysis": {
            "command": "python",
            "args": ["-m", "mcp_chat_analysis.server"],
            "env": {
                "QDRANT_URL": "http://localhost:6333",
                "NEO4J_URL": "bolt://localhost:7687",
                "NEO4J_USER": "neo4j",
                "NEO4J_PASSWORD": "你的密碼"
            }
        }
    }
}

📚 詳細文檔

架構

參見 ARCHITECTURE.md 獲取詳細圖表和文檔，瞭解：

• 系統組件及交互
• 數據流和處理流程
• 存儲模式和向量操作
• 工具集成機制

開發

1. 克隆倉庫：

git clone https://github.com/rebots-online/mcp-chat-analysis-server.git
cd mcp-chat-analysis-server

2. 安裝開發依賴項：

pip install -e ".[dev]"

3. 運行測試：

pytest tests/

貢獻

1. 叉克隆倉庫
2. 創建功能分支
3. 提交拉取請求

參見 CONTRIBUTING.md 瞭解指南。

📄 許可證

本項目採用 MIT License，詳情請參閱 LICENSE 文件。

相關項目

• 模型上下文協議（MCP）
• Claude Desktop
• Qdrant 向量數據庫
• Neo4j 圖形數據庫

支持

• 📖 文檔
• 🐛 問題跟蹤器
• 💬 討論區