---
description:
globs:
alwaysApply: true
---
# Cursor Conversations MCP Server - Project Overview
## **Core Concept**
This project creates an MCP (Model Context Protocol) server that **exposes your Cursor conversation history** to AI assistants like Claude. It acts as a bridge between your local Cursor chat database and AI tools.
## **Primary Goal**
**Enable AI assistants to analyze your actual coding conversations** to provide personalized, context-aware assistance based on your real development patterns and history.
## **Key Value Proposition**
- **Personalized Coding Rules**: Generate coding standards from your actual conversations, not generic best practices
- **Pattern Recognition**: Identify recurring themes and solutions in your development work
- **Context-Aware Help**: Get assistance informed by your specific projects and coding style
- **Historical Insights**: Learn from past problem-solving sessions and apply proven solutions
## **How It Works**
1. **Local Access**: Reads your Cursor conversation database directly (no external services)
2. **MCP Protocol**: Exposes conversation data through standardized MCP tools
3. **AI Integration**: AI assistants can query, analyze, and extract insights from your chat history
4. **Privacy First**: All data stays local - no external API calls or data sharing
## **Common Use Cases**
- `"Analyze my React conversations and create component guidelines"`
- `"Generate TypeScript rules based on my actual coding patterns"`
- `"Find similar debugging sessions and extract solutions"`
- `"Create project documentation from relevant conversations"`
## **Technical Architecture**
- **Database**: SQLite access to Cursor's conversation storage at [src/database/](mdc:src/database)
- **MCP Server**: TypeScript implementation at [src/server.ts](mdc:src/server.ts)
- **Tools**: Conversation analysis tools at [src/tools/](mdc:src/tools)
- **Entry Point**: Main configuration in [package.json](mdc:package.json) and [README.md](mdc:README.md)
**Bottom Line**: Transform your Cursor chat history into actionable development insights and personalized coding assistance.
