使用说明

项目简介

MCP Chat Analysis Server 是一个基于 Model Context Protocol (MCP) 构建的后端服务器，专注于聊天会话的语义分析。它通过向量嵌入技术实现语义搜索，利用知识图谱挖掘会话中的概念和关系，并提供会话指标分析工具，旨在为大型语言模型 (LLM) 应用提供丰富的会话上下文信息和分析功能。

主要功能点

语义搜索: 通过语义相似性搜索聊天记录中的相关消息和对话。
知识图谱: 构建消息、概念和主题之间的关系网络，用于深入理解会话内容。
会话分析: 分析会话模式、关键指标和动态，例如消息频率、响应时间等。
灵活导入: 支持多种聊天导出格式，方便用户导入不同平台的聊天数据。
MCP 集成: 无缝集成到 Claude 等 MCP 兼容的客户端，作为上下文信息提供方。

安装步骤

安装Python包:

pip install mcp-chat-analysis-server

配置数据库 (可选，如果需要持久化存储和知识图谱功能):
- 如果需要使用知识图谱和向量搜索功能，请确保已安装并运行 Neo4j 数据库和 Qdrant 向量数据库。
- 仓库提供了 Docker Compose 示例 (在 'Installation' -> '2. Set up databases' 部分)，方便用户快速启动数据库环境。
- 您也可以根据 'config.yml' 或 '.env.example' 中的配置项，手动配置数据库连接信息。

服务器配置

为了让 MCP 客户端（例如 Claude）连接到此服务器，您需要在客户端的 MCP 服务器配置中添加以下信息。以 'claude_desktop_config.json' 为例，配置如下：

{
  "mcpServers": {
    "chat-analysis": {  // 服务器名称，可以自定义
      "command": "python", // 启动服务器的命令
      "args": ["-m", "mcp_chat_analysis.server"], // 启动服务器的命令参数
      "env": { // 环境变量配置 (根据您的实际数据库配置修改)
        "QDRANT_URL": "http://localhost:6333", // Qdrant 向量数据库 URL
        "NEO4J_URL": "bolt://localhost:7687",  // Neo4j 数据库 Bolt URL
        "NEO4J_USER": "neo4j", // Neo4j 数据库用户名
        "NEO4J_PASSWORD": "your-password" // Neo4j 数据库密码，请替换为您的实际密码
      }
    }
  }
}

配置参数说明:

'"chat-analysis"': 您为该 MCP 服务器自定义的名称，在客户端配置中用于标识该服务器。
'"command": "python"': 指定用于启动服务器的可执行命令，这里使用 'python' 解释器。
'"args": ["-m", "mcp_chat_analysis.server"]': 指定传递给 'python' 命令的参数，'-m mcp_chat_analysis.server' 表示运行 'mcp_chat_analysis' 包中的 'server.py' 模块，即启动 MCP 服务器。
'"env": { ... }': 环境变量配置，用于服务器连接数据库。
- 'QDRANT_URL', 'NEO4J_URL', 'NEO4J_USER', 'NEO4J_PASSWORD': 数据库连接信息，请根据您实际部署的 Qdrant 和 Neo4j 数据库信息进行修改。

注意: 请确保您已根据实际情况配置 'env' 中的数据库连接信息，特别是 'NEO4J_PASSWORD' 需要替换为您 Neo4j 数据库的密码。

基本使用方法

启动服务器: 配置好 MCP 客户端后，启动客户端，客户端会自动连接并启动 MCP Chat Analysis Server。您也可以在命令行手动运行服务器：
```
python -m mcp_chat_analysis.server
```
使用工具: 通过 MCP 客户端 (如 Claude) 调用服务器提供的工具进行聊天分析。可用的工具包括：
- 'import_conversations': 导入和分析聊天记录。
- 'semantic_search': 进行语义搜索。
- 'analyze_metrics': 分析会话指标。
- 'extract_concepts': 提取会话概念。
具体工具的使用方法和参数，请参考仓库 README.md 文档中 "Available Tools" 部分的描述和示例。

关键词