context-continue-mcp

core3-coder/context-continue-mcp

3.3

If you are the rightful owner of context-continue-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The Context Continuation MCP Server is designed to manage and maintain context in AI development sessions, ensuring seamless transitions and continuity across interactions.

Tools
  1. context_start_session

    Start tracking a new context session.

  2. context_end_session

    End current session with summary.

  3. context_get_status

    Get current session and token usage info.

  4. context_track_message

    Add message to session tracking.

  5. context_restore_session

    Generate context restoration prompt.

Context Continuation MCP Server

CI codecov npm version Node.js License: MIT GitHub issues GitHub stars

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"]
    }
  }
}
  1. Restart Claude Desktop

  2. 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