Claude Server MCP

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.

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 install
Build the server:
npm run build
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