claude server

⚠️ 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:

1. Stability Improvements - Fixing core issues with home directory resolution 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 - 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

1. Clone the repository
2. Install dependencies:

   npm install

3. Build the server:

   npm run build

4. 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

{
  "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