Context Sync 🧠

The MCP server that gives AI assistants perfect memory across all your projects.

Context Sync is an MCP server that provides persistent memory, advanced code analysis, and cross-platform AI collaboration. Works with Claude Desktop, Cursor IDE, and more.

🚀 Quick Start

npm install -g @context-sync/server

That's it! Restart Claude Desktop and you're ready to go.

✨ What Context Sync Does

🧠 Persistent Memory

Cross-Chat Memory - Claude remembers everything across all chats
Project Context - Tracks architecture, tech stack, and decisions
Decision History - Never forget why you made choices
Local-First - All data stays on your machine

📂 Workspace Integration

File Reading - Claude can read any file in your project
Code Understanding - Analyze your codebase structure
Smart Search - Find files, content, and symbols instantly
Git Integration - Track changes and suggest commits

🔍 Advanced Code Analysis (v0.4.0)

Dependency Analysis - Understand imports, exports, and circular dependencies
Call Graph Analysis - Trace function calls and execution paths
Type Analysis - Find type definitions and track usage
Impact Analysis - See what breaks when you change code

🔀 Cross-Platform AI Sync (v0.4.0)

Platform Detection - Works with Claude Desktop, Cursor IDE, GitHub Copilot
Context Handoff - Seamlessly switch between AI platforms
Unified Memory - All AIs share the same project context
Easy Setup - One-click integration with Cursor IDE

🎯 Use Cases

Solo Developer

Monday: Start project with Claude
Tuesday: Continue in new chat - context preserved  
Friday: Come back - Claude remembers everything

Cross-Platform Development

Start in Claude Desktop → Switch to Cursor IDE → Continue seamlessly
Both AIs have full context of your project

Code Understanding

"How does authentication work?" 
→ Claude traces the auth flow across your codebase
→ Shows dependencies, call graphs, and type relationships

Impact Analysis

"What breaks if I change this function?"
→ Claude shows all callers and dependencies
→ Predicts impact before you make changes

🛠️ MCP Tools

Context Sync provides 30+ MCP tools organized into categories:

Core Memory Tools

init_project - Initialize or switch projects
get_project_context - Get current project context
save_decision - Save architectural decisions
save_conversation - Archive important discussions

Workspace Tools

set_workspace - Open project folders
read_file - Read any file in your project
get_project_structure - Visualize folder structure
scan_workspace - Intelligent project overview

File Operations

create_file - Create new files with preview
modify_file - Edit files with approval workflow
delete_file - Remove files with confirmation
undo_file_change - Rollback changes

Search & Discovery

search_files - Find files by name or pattern
search_content - Grep-like search across codebase
find_symbol - Jump to functions, classes, variables

Git Integration

git_status - Check repository status
git_diff - View differences between commits
git_branch_info - Get branch information
suggest_commit_message - Generate commit messages

Advanced Analysis (v0.4.0)

analyze_dependencies - Get complete dependency info
analyze_call_graph - Trace function relationships
find_type_definition - Find type definitions
trace_execution_path - Follow code execution paths

Cross-Platform Sync (v0.4.0)

switch_platform - Switch between AI platforms
get_platform_status - Check platform configuration
setup_cursor - Get Cursor IDE setup instructions
get_platform_context - Get platform-specific context

📖 How It Works

┌─────────────┐    ┌─────────────┐    ┌─────────────┐
│   Claude    │    │   Cursor    │    │  Copilot    │
│  Desktop    │    │     IDE     │    │  (coming)   │
└─────────────┘    └─────────────┘    └─────────────┘
       │                   │                   │
       └───────────────────┼───────────────────┘
                           │
                  ┌─────────────────┐
                  │  Context Sync   │
                  │   MCP Server    │
                  └─────────────────┘
                           │
                  ┌─────────────────┐
                  │   SQLite DB     │
                  │ ~/.context-sync │
                  └─────────────────┘

All your context is stored locally - never leaves your machine.

🚀 Installation

Option 1: NPM (Recommended)

npm install -g @context-sync/server

Option 2: Source Code

git clone https://github.com/Intina47/context-sync.git
cd context-sync
node setup.js

Restart Claude Desktop

Mac: Cmd+Q then reopen
Windows: Right-click tray icon → Exit, then reopen
Linux: Close and reopen

🔀 Cursor IDE Setup

Want to use Context Sync with Cursor? Super easy!

Quick Setup (Recommended)

Install Context Sync (if you haven't already):
```
npm install -g @context-sync/server
```
In Claude Desktop, type:
```
setup cursor
```
Claude will give you exact setup instructions for your OS! ✨

Manual Setup

Open Cursor: Settings → MCP

Add Context Sync:

{
  "mcpServers": {
    "context-sync": {
      "command": "npx",
      "args": ["-y", "@context-sync/server"]
    }
  }
}

Refresh MCP servers

Test It

In Cursor: "What's my current project?"

If connected, it'll know your projects! 🎉

🎬 Demo

Cross-Chat Memory

Chat 1:
You: "Initialize project 'TaskFlow' with Next.js and Supabase"
Claude: "Project initialized and saved to context"

Chat 2 (NEW):
You: "What project am I working on?"
Claude: "You're working on TaskFlow (Next.js + Supabase). 
Want to continue with authentication setup?"

Code Analysis

You: "Analyze dependencies for src/lib/auth.ts"
Claude: [Shows imports, exports, circular deps, and impact analysis]

You: "What calls the authenticate function?"
Claude: [Traces call graph and shows all callers]

Cross-Platform Sync

Claude Desktop: "I'll switch you to Cursor IDE"
Cursor IDE: "Welcome back! I can see you were working on 
the authentication flow. Ready to continue?"

📁 Data Storage

All context is stored locally at:

Mac/Linux: ~/.context-sync/data.db
Windows: %USERPROFILE%\.context-sync\data.db

Your data never leaves your machine.

🔧 Advanced Usage

Multiple Projects

You: "Switch to my blog project"
Claude: [loads blog context]

You: "What projects do I have?"
Claude: [Lists all projects with descriptions]

Cross-Platform Workflow

# Start in Claude Desktop
You: "Initialize project 'my-app'"
Claude: "Project created and saved"

# Switch to Cursor IDE  
You: "Switch to Cursor"
Claude: "Context handed off to Cursor IDE"

# Cursor IDE automatically has full context

Code Analysis Workflow

You: "Set workspace to /my/project"
You: "Analyze dependencies for src/components/Header.tsx"
Claude: [Shows complete dependency graph]

You: "What breaks if I change the Header component?"
Claude: [Shows all callers and impact analysis]

🐛 Troubleshooting

Claude doesn't see the MCP server

Verify installation: context-sync --version
Check Claude config: ~/.config/Claude/claude_desktop_config.json
Restart Claude Desktop completely

"No active project" error

You: "Initialize a project called 'test'"

Cross-platform sync not working

You: "Check platform status"
Claude: [Shows configuration status and setup instructions]

See TROUBLESHOOTING.md for detailed help.

🗺️ Roadmap

✅ v0.4.0 - Advanced Analysis & Cross-Platform Sync

🔍 Dependency analysis and call graph tracing
🔀 Cross-platform AI collaboration
🏷️ Type analysis and definition lookup
📊 Impact analysis and execution tracing

🔄 v0.5.0 - AI-Powered Features

🤖 Automatic context capture
🧠 Semantic code understanding
📊 Analytics and insights
🎓 Learning and suggestions

🔮 v0.6.0 - Team Collaboration

👥 Team context sharing
☁️ Optional cloud sync
🔐 Enterprise features
📈 Advanced analytics

See ROADMAP.md for full details.

🤝 Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

Priority areas:

🎨 UI/UX improvements
🔌 Additional IDE integrations
📝 Documentation improvements
🧪 Testing and QA

📄 License

MIT License - see LICENSE for details.

🙏 Acknowledgments

Built on the Model Context Protocol by Anthropic
Inspired by developers frustrated with AI memory loss
Thanks to the MCP community for feedback and support

⭐ Show Your Support

If Context Sync saves you time and frustration, give it a star! ⭐

📬 Contact & Community

Issues: GitHub Issues
Discussions: GitHub Discussions

Made with ❤️ by developers tired of explaining the same thing 10 times

Get Started • Demo • Roadmap • Contributing

Name		Name	Last commit message	Last commit date
.github/ISSUE_TEMPLATE		.github/ISSUE_TEMPLATE
bin		bin
documentation		documentation
src		src
.gitignore		.gitignore
.npmignore		.npmignore
CHANGELOG.md		CHANGELOG.md
CODE_OF_CONDUCT.md		CODE_OF_CONDUCT.md
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
MIGRATION_v0.2.0.md		MIGRATION_v0.2.0.md
README.md		README.md
ROADMAP.md		ROADMAP.md
TROUBLESHOOTING.md		TROUBLESHOOTING.md
package-lock.json		package-lock.json
package.json		package.json
setup.js		setup.js
tsconfig.json		tsconfig.json
yarn.lock		yarn.lock

Latest commit

History

Folders and files

Repository files navigation