Context Continue MCP

🚀 Context Continuation MCP Server

An MCP (Model Context Protocol) server that offers intelligent context management for AI development sessions, ensuring you never lose context due to token limits again!

🚀 Quick Start

📦 Installation

npm install -g context-continue-mcp

Usage with Claude Desktop

1. Add the following to your Claude Desktop configuration:

{
  "mcpServers": {
    "context-continue": {
      "command": "context-mcp",
      "args": ["--project", "/path/to/your/project"]
    }
  }
}

2. Restart Claude Desktop.
3. Start using context tools in your conversations:
   • context_start_session - Begin tracking a new session.
   • context_track_message - Track important messages.
   • context_get_status - Check token usage.
   • context_restore_session - Generate a restoration prompt.

✨ Features

• Automatic Context Tracking: Monitor token usage and conversation flow.
• Intelligent Session Breaks: Receive notifications before reaching context limits.
• Seamless Restoration: Generate context restoration prompts for new sessions.
• Project Management: Track milestones, decisions, and progress across sessions.
• File-Based Storage: Human-readable markdown files that are compatible with git.

💻 Usage Examples

Basic Usage

You can start using the server by following the installation and configuration steps in the Quick Start section.

Advanced Usage

Here are more detailed usage scenarios for different tools:

Session Management

• context_start_session - Start tracking a new context session.
• context_end_session - End the current session with a summary.
• context_get_status - Get current session and token usage information.

Context Tracking

• context_track_message - Add a message to session tracking.
• context_track_progress - Update project progress.
• context_add_milestone - Add a project milestone.

Restoration

• context_restore_session - Generate a context restoration prompt.
• context_get_project_summary - Get a full project overview.

📚 Documentation

How It Works

1. Start a Session: Initialize context tracking for your project.
2. Track Progress: Important messages and decisions are automatically logged.
3. Monitor Usage: Receive warnings when approaching token limits.
4. Seamless Continuation: Generate restoration prompts for new sessions.

File Structure

The server creates a .context directory in your project:

your-project/
├── .context/
│   ├── config.json
│   ├── project_summary.md
│   ├── sessions/
│   │   ├── session_001_2025-05-31.md
│   │   └── session_002_2025-06-01.md
│   ├── progress/
│   │   ├── milestones.md
│   │   └── decisions.md
│   └── artifacts/
└── your-code/

🔧 Technical Details

Quality Assurance

This project maintains high code quality through:

• 🧪 Comprehensive Testing: 43+ unit tests with 95%+ coverage.
• 🔄 Continuous Integration: Automated testing on Node.js 18.x, 20.x, 21.x.
• 🌍 Cross-Platform: Tested on Ubuntu, Windows, and macOS.
• 📊 Code Coverage: Real-time coverage tracking with Codecov.
• 🏗️ Build Verification: Automated build and CLI functionality testing.
• 📦 Package Validation: Pre-publish testing and compatibility checks.

Running Tests

# Run all tests
npm test

# Run tests with coverage
npm run test:coverage

# Run specific test suites
npm test token-counter
npm test session-tracker
npm test context-manager

# Watch mode for development
npm run test:watch

Development

git clone https://github.com/core3-coder/context-continue-mcp
cd context-continue-mcp
npm install
npm run build
npm start

📄 License

This project is licensed under the MIT license. See the LICENSE file for details.