MCP聊天分析服务器

一个模型上下文协议 (MCP) 服务器，通过向量嵌入和知识图谱实现对聊天对话的语义分析。该服务器提供用于分析聊天数据、执行语义搜索、提取概念和分析对话模式的工具。

主要特性

• 🔍 语义搜索: 使用向量相似性查找相关的消息和对话
• 🕸️ 知识图谱: 导航消息、概念和主题之间的关系
• 📊 对话分析: 分析模式、指标和对话动态
• 🔄 灵活导入: 支持各种聊天导出格式
• 🚀 MCP集成: 轻松与 Claude 和其他 MCP 兼容系统集成

快速开始

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

# 设置配置
cp config.example.yml config.yml
# 使用您的数据库设置编辑 config.yml
# Edit config.yml with your database settings

# 运行服务器
python -m mcp_chat_analysis.server

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": "your-password"
      }
    }
  }
}

可用工具

import_conversations

导入和分析聊天对话

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

semantic_search

通过语义相似性搜索对话

{
    "query": "machine learning applications",
    "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
}

架构

请参阅 ARCHITECTURE.md 以获取详细的图表和文档，内容包括：

• 系统组件和交互
• 数据流和处理管道
• 存储模式和向量操作
• 工具集成机制

前提条件

• 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

开发

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. Fork 存储库
2. 创建一个功能分支
3. 提交一个 pull request

请参阅 CONTRIBUTING.md 以获取指南。

许可证

MIT 许可证 - 有关详细信息，请参阅 LICENSE 文件。

相关项目

• 模型上下文协议 (MCP)
• Claude Desktop
• Qdrant 向量数据库
• Neo4j 图数据库

支持

• 📖 文档
• 🐛 问题跟踪器
• 💬 讨论