Claude Server MCP
local-only server
The server can only run on the client’s local machine because it depends on local resources.
Claude Server MCP
⚠️ IMPORTANT: Project Status ⚠️
This project is in early development (v0.1.0) and is NOT READY FOR PRODUCTION USE. It is currently undergoing a significant rewrite to address several critical issues. Please check the Issues page for current limitations and planned improvements.
We recommend waiting for a stable release (v0.2.0+) before using this in any critical workflows.
A Model Context Protocol (MCP) server that provides sophisticated context management capabilities for Claude, enabling persistent context across sessions, project-specific context organization, and conversation continuity.
Current Limitations
- The server currently has compatibility issues with MCP clients other than Claude Desktop
- Context listing functionality is limited without specific project IDs
- Security features are minimal and not production-ready
- Error handling is basic and may not provide helpful guidance
- No testing infrastructure is in place
Development Roadmap
This project is actively being improved. Key upcoming enhancements include:
- Stability Improvements - Fixing core issues with home directory resolution and context listing
- Enhanced Error Handling - Better error messages and recovery mechanisms
- Security Enhancements - Input validation, path sanitization, and data protection
- Advanced Context Management - Versioning, search, and better organization
For a more detailed roadmap, see our Comprehensive Analysis branch.
Features
- Project Context Management
- Hierarchical context organization
- Parent-child relationships
- Cross-referencing between contexts
- Project-specific metadata
- Conversation Continuity
- Session-based context tracking
- Conversation chaining
- Metadata-rich context storage
- Flexible tagging system
- Efficient Storage
- Organized directory structure
- JSON-based storage
- Quick lookup indexing
- Asynchronous operations
Installation
The server is automatically configured in your Claude desktop app's MCP settings. All contexts are stored in ~/.claude/
for better organization:
Tools
Project Context Management
Conversation Management
Context Retrieval
Documentation
- Context Management Guide - Detailed guide on context types and usage
- Architecture Overview - Technical implementation details
- Usage Guide - General usage instructions
- Claude Desktop Integration - Integration with Claude Desktop
Development
- Clone the repository
- Install dependencies:Copy
- Build the server:Copy
- The server will be built to
build/index.js
Configuration
The server is configured through the Claude desktop app's configuration file at:
~/Library/Application Support/Claude/claude_desktop_config.json
Contributing
Contributions are welcome! Please feel free to submit issues and pull requests.
License
MIT
You must be authenticated.
Provides sophisticated context management for Claude, enabling persistent context across sessions, project-specific organization, and conversation continuity.
- Current Limitations
- Development Roadmap
- Features
- Installation
- Tools
- Documentation
- Development
- Configuration
- Contributing
- License