core3-coder/context-continue-mcp
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.
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_track_message
Add message to session tracking.
context_restore_session
Generate context restoration prompt.
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