MCP Claude Context Server v0.5.0

A powerful Model Context Protocol (MCP) server for extracting, storing, searching, and analyzing Claude.ai conversations with enhanced database storage, semantic search, and multiple export formats.

🚀 What's New in v0.5.0

• SQLite Database Storage - Migrate from JSON files to efficient database

• Semantic Search - AI-powered search using sentence transformers

• Multiple Export Formats - Obsidian, PDF, JSON, CSV

• Easy Deployment - Docker support and one-click installers

• Performance Improvements - 10x faster search, 35% faster operations

Related MCP server: conversation-history-mcp

Features

Core Functionality

• ✅ Direct API access for Claude.ai conversations

• ✅ Chrome extension for full message extraction

• ✅ SQLite database with full-text search

• ✅ Semantic search capabilities

• ✅ Multiple export formats (Obsidian, PDF, JSON, CSV)

• ✅ Bulk operations and analytics

• ✅ Session management with auto-refresh

• ✅ Real-time analytics dashboard

Architecture

┌─────────────────┐     ┌──────────────────┐     ┌─────────────────┐
│  Claude.ai Web  │────▶│ Chrome Extension │────▶│  Bridge Server  │
└─────────────────┘     └──────────────────┘     └─────────────────┘
                                                          │
                                                          ▼
┌─────────────────┐     ┌──────────────────┐     ┌─────────────────┐
│   MCP Client    │◀────│    MCP Server    │◀────│    Database     │
│  (Claude App)   │     │   (Enhanced)     │     │  (SQLite+FTS)   │
└─────────────────┘     └──────────────────┘     └─────────────────┘
                                │
                        ┌───────┴───────┐
                        ▼               ▼
                  ┌──────────┐    ┌──────────┐
                  │ Exporters│    │  Search  │
                  │ (PDF/MD) │    │ (AI/FTS) │
                  └──────────┘    └──────────┘

🛠️ Installation

Quick Start with uvx (Recommended - No Installation!)

Add to your Claude Desktop config:

{
  "mcpServers": {
    "claude-context": {
      "command": "uvx",
      "args": ["mcp-claude-context"],
      "env": {
        "CLAUDE_SESSION_KEY": "sk-ant-sid01-...",
        "CLAUDE_ORG_ID": "28a16e5b-..."
      }
    }
  }
}

That's it! No installation needed. See full uvx guide →

Quick Start with Docker

# Using pre-built image
docker run -d \
  --name mcp-claude-context \
  -p 8000:8000 \
  -v $(pwd)/data:/app/data \
  hamzaamjad/mcp-claude-context:latest

# Or with docker-compose
curl -O https://raw.githubusercontent.com/hamzaamjad/mcp-claude-context/main/docker-compose.simple.yml
docker-compose -f docker-compose.simple.yml up -d

One-Click Installer

# Mac/Linux
curl -sSL https://raw.githubusercontent.com/hamzaamjad/mcp-claude-context/main/deployment/one-click-install.sh | bash

# Windows (PowerShell)
iwr -useb https://raw.githubusercontent.com/hamzaamjad/mcp-claude-context/main/deployment/install.ps1 | iex

Manual Installation

1. Prerequisites:

   • Python 3.11+

   • Chrome browser

   • Poetry (Python package manager)

2. Install dependencies:

   poetry install

3. Initialize database:

   poetry run python -c "from src.models.conversation import init_database; init_database()"

4. Install Chrome extension:

   • Open Chrome → chrome://extensions/

   • Enable "Developer mode"

   • Click "Load unpacked" → Select extension/ directory

5. Start the server:

   poetry run python -m src.direct_api_server

📚 Available MCP Tools

Conversation Management

Search & Analytics

Export & Operations

System Management

💡 Usage Examples

Basic Operations

# List conversations
{
  "tool": "list_conversations",
  "arguments": {
    "session_key": "YOUR_SESSION_KEY",
    "org_id": "YOUR_ORG_ID",
    "limit": 50,
    "sync_to_db": true
  }
}

# Search with AI
{
  "tool": "semantic_search",
  "arguments": {
    "query": "discussions about machine learning",
    "search_type": "hybrid",
    "top_k": 10
  }
}

# Export to Obsidian
{
  "tool": "export_to_obsidian",
  "arguments": {
    "conversation_ids": ["conv-id-1", "conv-id-2"],
    "vault_path": "/path/to/obsidian/vault"
  }
}

Chrome Extension Usage

1. Extract single conversation:

   • Navigate to conversation on Claude.ai

   • Click extension icon

   • Click "Extract Current Conversation"

2. Bulk extract all conversations:

   • Click extension icon

   • Click "Extract All Conversations"

   • Monitor progress in popup

3. View analytics:

   • Visit http://localhost:8765/dashboard

   • See statistics, trends, and insights

🔧 Configuration

Environment Variables

Getting Session Credentials

1. Log into Claude.ai

2. Open Chrome DevTools (F12)

3. Go to Application → Cookies

4. Find sessionKey value

5. Find org_id in Network tab API calls

📊 Performance

v0.5.0 Improvements

• Search Speed: 10x faster with SQLite FTS5

• Storage: 20% less space with database compression

• Operations: 35% faster read/write performance

• Scalability: Handles 100K+ conversations efficiently

Benchmark Results

🚀 Advanced Features

Semantic Search

The server uses sentence transformers for AI-powered search:

• Find similar conversations

• Search by meaning, not just keywords

• Discover related topics automatically

Obsidian Integration

Export conversations with:

• Proper frontmatter metadata

• Automatic backlinks

• Daily notes integration

• Tag organization

• Dataview queries

Bulk Operations

Process multiple conversations:

{
  "tool": "bulk_operations",
  "arguments": {
    "operation": "analyze",
    "conversation_ids": ["id1", "id2", "id3"],
    "params": {}
  }
}

🐛 Troubleshooting

Common Issues

1. "Session expired" error

   • Get fresh session key from Claude.ai

   • Use update_session tool

2. Chrome extension not connecting

   • Ensure bridge server is running (port 9222)

   • Check extension permissions

3. Database locked error

   • Ensure only one server instance running

   • Check file permissions

4. Search not finding results

   • Run rebuild_search_index tool

   • Verify conversations are in database

Debug Mode

Enable detailed logging:

LOG_LEVEL=DEBUG poetry run python -m src.direct_api_server

🤝 Contributing

Contributions are welcome! Please:

1. Fork the repository

2. Create a feature branch

3. Add tests for new features

4. Submit a pull request

Development Setup

# Install dev dependencies
poetry install --with dev

# Run tests
poetry run pytest

# Format code
poetry run black src/
poetry run ruff src/

📄 License

MIT License - see LICENSE file

🙏 Acknowledgments

• Built on Model Context Protocol

• Uses Sentence Transformers for semantic search

• PDF generation with ReportLab

📞 Support

• GitHub Issues

• Documentation

• Changelog

Note: This tool is not affiliated with Anthropic. Use responsibly and respect rate limits.