Claude Server

🚀 Code Name: Claude Server MCP

A Model Context Protocol (MCP) server that provides advanced context management capabilities, supporting persistent cross - session context, project - based context organization, and conversation continuity, offering context management for Claude.

🚀 Quick Start

This server is a Model Context Protocol (MCP) server with advanced context management features. It supports persistent cross - session context, project - based context organization, and conversation continuity, providing context management capabilities for Claude.

⚠️ Important Note

This project is in the early development stage (v0.1.0) and is not ready for production use. It is undergoing a major refactoring to address several key issues. Please check the Issues page for current limitations and improvement plans.

We recommend not using this project for any critical workflows until a stable version (v0.2.0+) is released.

✨ Features

Project Context Management

• Hierarchical context organization
• Support for parent - child relationships
• Cross - referencing between contexts
• Project - specific metadata

Conversation Continuity

• Session - based context tracking
• Chained conversation processing
• Rich context storage metadata
• Flexible tagging system

Efficient Storage

• Neat directory structure
• JSON format storage
• Fast lookup index
• Support for asynchronous operations

📦 Installation

The server is automatically configured in the MCP settings of your Claude desktop application. All contexts are stored in ~/.claude/ for better organization:

~/.claude/
├── contexts/           # Normal conversation contexts
├── projects/          # Project - specific contexts
└── context - index.json # Fast lookup index

💻 Usage Examples

Basic Usage

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: "parent-feature-design",
    contextType: "design"
  }
});

Conversation Context Management

// Create a new conversation context
use_mcp_tool({
  server_name: "claude-server", 
  tool_name: "create_dialog_context",
  arguments: {
    sessionId: "12345",
    contextId: "welcome-message"
  }
});

📚 Documentation

The project documentation is located at DOCS.md.

🔧 Technical Details

Current Limitations

• The server is currently only compatible with specific MCP clients such as Claude Desktop.
• The context list function is limited without a specific project ID.
• Security features are minimal and not suitable for production use.
• Error handling is basic and may not provide useful guidance.
• There is no testing infrastructure.

Development Roadmap

This project is actively being improved. Key enhancements coming soon include:

1. Stability Improvements - Fix core issues with home directory parsing and context listing.
2. Enhanced Error Handling - Better error messages and recovery mechanisms.
3. Security Enhancements - Input validation, path sanitization, and data protection.
4. Advanced Context Management - Version control, search, and better organization.

For more details, please check our comprehensive analysis branch.

📄 License

This project is licensed under the MIT license.

💡 Usage Tip

Contributions are welcome! Please feel free to submit issues and pull requests.