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
- Add to your Claude Desktop configuration:
{
"mcpServers": {
"context-continue": {
"command": "context-mcp",
"args": ["--project", "/path/to/your/project"]
}
}
}
-
Restart Claude Desktop
-
Start using context tools in your conversations:
context_start_session- Begin tracking a new sessioncontext_track_message- Track important messagescontext_get_status- Check token usagecontext_restore_session- Generate restoration prompt
Tools Available
Session Management
context_start_session- Start tracking a new context sessioncontext_end_session- End current session with summarycontext_get_status- Get current session and token usage info
Context Tracking
context_track_message- Add message to session trackingcontext_track_progress- Update project progresscontext_add_milestone- Add project milestone
Restoration
context_restore_session- Generate context restoration promptcontext_get_project_summary- Get full project overview
How It Works
- Start a Session: Initialize context tracking for your project
- Track Progress: Important messages and decisions are automatically logged
- Monitor Usage: Get warnings when approaching token limits
- 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