-
securityF
license-
qualityA Model Context Protocol server that enables Claude to manage software development projects with complete context awareness and code execution through Docker environments.
Last updated -
5
3
The Claude Server MCP provides sophisticated context management for Claude, enabling persistent, organized, and efficient storage of project and conversation contexts.
Save Project Contexts: Store project-specific contexts with hierarchical organization, parent-child relationships, and metadata
Save Conversation Contexts: Maintain conversation continuity across sessions with tagging and chaining
Retrieve Contexts: Fetch specific contexts by ID for quick access
List Contexts: Filter contexts by tags, type, or project ID for better organization
Efficient Storage: Uses structured directory (~/.claude/) and JSON-based storage for quick lookups
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:
~/.claude/
├── contexts/ # General conversation contexts
├── projects/ # Project-specific contexts
└── context-index.json # Quick lookup index
Tools
Project Context Management
// Save project context
use_mcp_tool({
server_name: "claude-server",
tool_name: "save_project_context",
arguments: {
id: "feature-design-v1",
projectId: "my-project",
content: "Design discussion...",
parentContextId: "requirements-v1",
references: ["api-spec-v1"],
tags: ["design"],
metadata: { status: "in-progress" }
}
});
Conversation Management
// Save conversation context
use_mcp_tool({
server_name: "claude-server",
tool_name: "save_conversation_context",
arguments: {
id: "chat-2024-01-01",
sessionId: "session-123",
content: "Discussion content...",
continuationOf: "previous-chat-id",
tags: ["meeting"]
}
});
Context Retrieval
// Get context
use_mcp_tool({
server_name: "claude-server",
tool_name: "get_context",
arguments: {
id: "feature-design-v1",
projectId: "my-project"
}
});
// List contexts
use_mcp_tool({
server_name: "claude-server",
tool_name: "list_contexts",
arguments: {
projectId: "my-project",
tag: "design",
type: "project"
}
});
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:
npm installBuild the server:
npm run buildThe 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
{
"mcpServers": {
"claude-server": {
"command": "node",
"args": ["/path/to/claude-server/build/index.js"]
}
}
}
Contributing
Contributions are welcome! Please feel free to submit issues and pull requests.
License
MIT
Related MCP Servers
- -securityFlicense-qualityA Model Context Protocol server for Claude Desktop that provides structured memory management across chat sessions, allowing Claude to maintain context and build a knowledge base within project directories.Last updated -3
- AsecurityFlicenseAqualityA powerful context management system that maintains persistent context across coding sessions, helping development teams track project structure, dependencies, and progress.Last updated -65
- -securityFlicense-qualityCreates and maintains a semantic knowledge graph of code that allows maintaining context across sessions with Claude, providing advanced search capabilities without requiring the entire codebase in the context window.Last updated -6