MCP Chat Analysis Server

A Model Context Protocol (MCP) server that enables semantic analysis of chat conversations through vector embeddings and knowledge graphs. This server provides tools for analyzing chat data, performing semantic search, extracting concepts, and analyzing conversation patterns.

Key Features

🔍 Semantic Search: Find relevant messages and conversations using vector similarity
🕸️ Knowledge Graph: Navigate relationships between messages, concepts, and topics
📊 Conversation Analytics: Analyze patterns, metrics, and conversation dynamics
🔄 Flexible Import: Support for various chat export formats
🚀 MCP Integration: Easy integration with Claude and other MCP-compatible systems

Quick Start

# Install the package
pip install mcp-chat-analysis-server

# Set up configuration
cp config.example.yml config.yml
# Edit config.yml with your database settings

# Run the server
python -m mcp_chat_analysis.server

MCP Integration

Add to your 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"
      }
    }
  }
}

Available Tools

import_conversations

Import and analyze chat conversations

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

semantic_search

Search conversations by semantic similarity

{
    "query": "machine learning applications",
    "limit": 10,
    "min_score": 0.7
}

analyze_metrics

Analyze conversation metrics

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

extract_concepts

Extract and analyze concepts

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

Architecture

See ARCHITECTURE.md for detailed diagrams and documentation of:

System components and interactions
Data flow and processing pipeline
Storage schema and vector operations
Tool integration mechanism

Prerequisites

Python 3.8+
Neo4j database for knowledge graph storage
Qdrant vector database for semantic search
sentence-transformers for embeddings

Installation

Install the package:

pip install mcp-chat-analysis-server

Set up databases:

# Using Docker (recommended)
docker compose up -d

Configure the server:

cp .env.example .env
# Edit .env with your settings

Development

Clone the repository:

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

Install development dependencies:

pip install -e ".[dev]"

Run tests:

pytest tests/

Contributing

Fork the repository
Create a feature branch
Submit a pull request

See CONTRIBUTING.md for guidelines.

License

MIT License - See LICENSE file for details.

Support

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Facilitates semantic analysis of chat conversations through vector embeddings and knowledge graphs, offering tools for semantic search, concept extraction, and conversation pattern analysis.

Related Resources

Reddit Discussion about this server

Related MCP Servers

mcp-server-chatsum
chatmcp
A
security
F
license
A
quality
Summarizes your chat messages.
Last updated -
1
1,008
TypeScript
dbt Semantic Layer MCP Server
TommyBez
-
security
A
license
-
quality
A server that enables querying the dbt Semantic Layer through natural language conversations with Claude Desktop and other AI assistants, allowing users to discover metrics, create queries, analyze data, and visualize results.
Last updated -
10
TypeScript
MIT License
VRChat MCP Server
sawa-zen
A
security
A
license
A
quality
A Model Context Protocol server that allows AI assistants to interact with the VRChat API, enabling retrieval of user information, friends lists, and other VRChat data through a standardized interface.
Last updated -
7
6
40
TypeScript
MIT License
Better Qdrant MCP Server
wrediam
A
security
A
license
A
quality
A Model Context Protocol server that enables semantic search capabilities by providing tools to manage Qdrant vector database collections, process and embed documents using various embedding services, and perform semantic searches across vector embeddings.
Last updated -
4
43
TypeScript
MIT License

View all related MCP servers

MCP Chat Analysis Server