Context Continuation MCP Server

Context Continuation MCP Server

An MCP (Model Context Protocol) server that provides intelligent context management for AI development sessions. Never lose context when hitting token limits again!

Features

• Automatic Context Tracking: Monitor token usage and conversation flow
• Intelligent Session Breaks: Get notified before hitting 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 work with git

Quick Start

Installation

npm install -g context-continue-mcp

Usage with Claude Desktop

1. Add 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 restoration prompt

Tools Available

Session Management

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

Context Tracking

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

Restoration

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

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: Get 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/

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

MIT - see LICENSE file for details